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MS EXPRESSION TOOLS 

I MUOVI STRUMENTI PER LA CREAZIONE 
DELLE INTERFACCE GRAFICHE, ANCHE 3D 



Rivista + "Le grandi guide di ioProgrammo" n°8 a € 12,90 in più 



RIVISTA+UBRO+CD €9,90 



VERSIONE STANDARD 



[~j I RIVISTA+CD €6,90 



ROGRAMMO 



PER ESPERTI E PRINCIPIANTI 



APPLICAZIONI PRONTE PER 




IL SISTEMA DEL FUTURO E ALLE PORTE! FATTI TROVARE PREPARATO 
Usa il .NET framework 3.0 e rendi subito disponibile^ 
il tuo codice per la nuova piattaforma 

Teoria e tecnica 

Cosa cambia nel linguaggio 
e nelle librerie . Le cose da sapere 
per programmare meglio 

La migrazione 

Passo dopo passo le cose da fare 
per portare il tuo software al nuovo 
sistema senza problemi 

La pratica 

Facciamo convivere le vecchie 
3 Windows Form con il nuovo 
£ XAML in modo semplice 





SHOP 

-MICROSOFT 



CHATTA CON AJAX 

Metti in comunicazione gli utenti del tuo sito, senza installare 
un server e fornendogli un'applicazione web che ha tutte 
le comodità di un software standalone 



.NET FRAMEWORK 



NOVITÀ 



CREIAMO REPORT 
ll\l FORMATO RTF 



IROniPYTHOni: ARRIVA 
IL PITONE SECONDO 



Ecco come creare documenti direttamente Scopri, Il linguaggio che fa muovere Google 
comprensibili da Microsoft Word ma ottimizzato per le tecnologie Microsoft 



Algoritmi evolutivi, ovvero sviluppare software 
che autoapprende dalle proprie esperienze 
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SISTEMA 



UN CALENDARIO 
UNIVERSALE eeh 

Ecco come fanno Outlook 
e gli altri a scambiarsi 
gli appuntamenti 

APPLICAZIONI 
MULTILINGUAbuu 

Crea software pronto 
per il mondo senza dover 
riscrivere il codice 

GESTIRE BENE 
LA MEMORIA bb 

le tecniche da utilizzare 
affinché il tuo programma 
non vada fuori controllo 

METTIAMO UN PDF 
DENTRO L'IPODdsh 

Convertiamolo in un 
formato comprensibile 
dal famoso lettore 

SOFTWARE 

NEL BROWSER EU 

Sfrutta AJAX per creare 
interfacce completamente 
indipendenti dal Web 



UN MODULO DI 
REWRITE PER MS cm 

Cloniamo alcune funzioni 
tipiche dell'htaccess di Apache 
usando gli HttpHandler 

COMPRENDERE 
LE REGEX eswhìIIìH 

Per effettuare nel testo 

le ricerche che non si possono 

fare in altro modo 



CORSI 



ECLIPSE 

E LE REVISIONICI 

Versioni sempre sotto controllo 
con gli automatismi del tuo 
IDE preferito 
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• Il 



CRUCIALE 



Capita di tanto in tanto in informatica, un 
momento in cui improvvisamente tutto sembra 
cambiare radicalmente. E' stato così per il passag- 
gio da Windows 3.1 a Windows 95 e poi a Windows 
98. E' stato così per il passaggio di Mac al nuovo 
kernel basato su BSD, ed è stato così quando sono 
nati i primi linguaggi di scripting per il Web. Così 
oggi ci siamo di nuovo. E' il momento di Windows 
Vista. Questa volta il carico di novità è importante 
e lo è ancora di più per chi programma con le tec- 
nologie Microsoft. Il nuovo sistema operativo pre- 
senta un'enorme serie di novità. E d'altra parte il 
.NET framework 3.0 segue di pari passo le nuove 
caratteristiche associate al sistema per cui è stato 
pensato: Vista. E' anche vero che i layer che vengo- 
no montati sopra il nuovo framework migliorano 
ed estendono la precedente versione senza per 
questo stravolgerla, ma è anche vero che le novità 
sono talmente tante e dense di innovazioni tecno- 
logica che è impossibile non annoverare il 



momento del rilascio di Windows Vista con un 
momento di svolta cruciale per l'evoluzione del- 
l'informatica in generale. Tanto più che insieme a 
questa importante novità se ne presentano altre 
che rendono questo inizio di nuovo anno un 
momento eccezionale. Java 6 è alle porte, la diffu- 
sione di Linux assume proporzioni decisamente 
degne di nota. XGL e AIXGL sono perfettamente 
parogonabili alle funzioni 3D presenti in Vista. Si 
sta studiando alla nuova versione di PHP. 
Insomma tutto sembra muoversi di concerto per 
far si che questo 2007 venga ricordato come l'anno 
in cui il mercato ha ricominciato a muoversi. Per 
noi sviluppatori è tempo di migrazione, di portare 
le nostre applicazioni su piattaforme tecnologica- 
mente innovative, è il momento di consigliare ai 
nostri clienti strade nuove e più produttive. Se 
vogliamo cogliere questa occasione dobbiamo 
essere pronti a stare al passo con i tempi, ma d'al- 
tra parte chi meglio di noi può farlo? 



CJ CD J WEB 

nome_file.zip 



All'inizio di ogni articolo, troverete un simbolo 
che indicherà la presenza di codice e/o software 
allegato, che saranno presenti sia sul CD (nella 
posizione di sempre \soft\codice\ e \soft\tools\) 
sia sul Web, all'indirizzo 
http://cdrom.ioprogrammo.it. 
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IL SISTEMA DEL FUTURO E ALLE PORTE! FATTI TROVARE PREPARATO 

Usa il .NET framework 3.0 e rendi subito 
disponibile il tuo codice per la nuova pia ttafor ma 

• Teoria e tecnica: cosa cambia nel 
linguaggio e nelle librerie. Le cos 
da sapere per programmare meglio 

• La migrazione: Passo dopo passo 
le cose da fare per portare il tuo 
software al nuovo sistema 
senza problemi 



• Pratica: Facciamo convivere 
le vecchie Windows Form 
il nuovo XAML in modo sempl 
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CHATTA CON AJAX 

Metti in comunicazione gli utenti del tuo sito, senza installare 
un server e fornendogli un'applicazione Web che ha tutte 
le comodità di un software standalone 

pag. 45 



IOPROGRAMMO WEB 



Gli strumenti di sviluppo del futuro 
pag. 30 

Expression: é questo il nome che 
Microsoft ha voluto dare alla sua nuova 
suite per la creazione di interfacce gra- 
fiche e contenuti multimediali. La novità è 
che questa volta tutto è pensato per 
aiutare gli sviluppatori 

Una mailing list gestita sul Web 

pag. 36 

Abbiamo realizzato un servizio che 
gestisce una lista di distribuzione della 
posta senza aver installato nessun soft- 
ware lato server ma solo delle pagine 
Web. Vediamo ora come creare il clienty 
per la consultazione 

US come Aphace con l'Uri Rewriting 
pag. 52 

Si tratta di una delle funzionalità più 
amate dagli utilizzatori del noto Web 
server opensource. Consente di eliminare 
i parametri lunghissimi che solitamente 
caratterizzano una Queri_string. 
Creiamone uno per US 

Javascript e le regular expression . . . 
pag. 58 

In questo articolo apprenderete cosa sono le 
espressioni regolari e come utilizzarle in 
Javascript. Vedremo come sarà possibile vali- 
dare, lato client e-mail e quant f altro e come 
estrarre parti di stringhe 







SISTEMA 



Il browser sul desktop 

pag. 64 

Progettare un interfaccia è spesso più 
facile per il Web che per le applicazioni 
standalone. Allora perchè non unire le 
due cose progettando software che gira 
sul tuo computer ma ha una grafica 
HTML? 

Appuntamenti: gestiamoli in Java 

pag. 70 

Vi è mai capitato di utilizzare la funzione 
calendario di Outlook? Sapevate che 
quando invitate qualcuno ad una riunione 
utilizzate uno standard? In questo artico- 
lo vedremo come accedere ai calendari 



In questo articolo cercheremo di utilizza- 
re Java e una famosa libreria per aumen- 
tare le potenzialità del nostro Ipod, tra- 
sformando i file PDF in documenti leggi- 
bili sul nostro lettore multimediale 

Programmare .Net con Python . . 
pag. 79 

La diffusione di Python come linguaggio 
di programmazione ha quasi raggiunto 
quella di .Net, e con Ironpython è ora 
possibile scrivere script in Python e com- 
pilarli per la piattaforma microsoft 

Software internazionale 

pag. 84 

In un'epoca in cui le distanze si sono 
ormai annullate, è importante produrre 
applicazioni fruibili in ogni parte del 
mondo. Il principio base è la localizzazio- 
ne, vediamo come scrivere codice multi- 
lingua 

Creare report RTF con Asp.Net 2.0 
pag. 91 

La creazione di reportistica è sempre 
stata demandata a pacchetti esterni. Ma 
con RTF si può implementare in pochi e 
semplici passi, soprattutto si può utiliz- 
zare un formato universale almeno 
quanto PDF 

Tenere la memoria sotto controllo 
pag. 96 

Concludiamo il viaggio nel paese degli 
Smart Pointers, analizzando quelli più 
avanzati offerti dalla libreria Boost. La 
conoscenza di questi elementi è un obbli- 
go per ogni programmatore C++ 
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Facciamo leggere 



PDF all'lpod . 
, pag. 74 



Gli allegati di ioProgrammo 

pag. 6 
// software in allegato alla rivista 

Il libro di ioProgrammo 

pag. 8 

// contenuto del libro in allegato 
alla rivista 

News pag. 14 

Le più importanti novità del 
mondo della programmazione 

Software pag. 108 

/ contenuti del CD allegato ad 
ioProgrammo. 



CORSI BASE 



Eclipse 

nel mondo reale 

pag. 103 

Che usiate eclipse per 

sviluppare progetti open source 

o per il vostro lavoro in azienda, 

le sue integrazioni con i Tool più 

usati del mondo Java possono 

facilitarvi la vita. Vediamo quali 

sono gli strumenti a 

disposizione 



SOLUZIONI 



Ant colony 
optimization 

pag. 110 

Osservare il comportamento 

"sociale" di alcuni animali e 

insetti può essere un utile 

insegnamento per riprodurlo 

con un modello argoritmico. 

Si tratta di una nuova 

frontiera dello sviluppo: la 

Swarm intellingence 



QUALCHE CONSIGLIO UTILE 

I nostri articoli si sforzano di essere 
comprensibili a tutti coloro che ci 
seguono. Nel caso in cui abbiate 
difficoltà nel comprendere esattamente 
il senso di una spiegazione tecnica, è 
utile aprire il codice allegato all'articolo 
e seguire passo passo quanto viene 
spiegato tenendo d'occhio l'intero 
progetto. Spesso per questioni di spazio 
non possiamo inserire il codice nella 
sua interezza nel corpo dell'articolo. Ci 
limitiamo a inserire le parti necessarie 
alla stretta comprensione della tecnica. 
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TURBO C++ PER WINDOWS 2006 

C++ Secondo Borland 

Borland è una delle software house storiche nel mercato 
dello sviluppo. Non si dimentica che proprio Borland ha svi- 
luppato uno dei primi linguaggi completamente ad oggetti: 
l'object Pascal già a metà degli anni 90. Allo stesso modo è 
da attribuirsi a Borland anche l'avvento degli IDE Rad con il 
mitico Delphi. Per qualche anno si era allontanata dal merca- 
to dei tool di sviluppo rivolti alla produttività individuale e 
solo di recente è ritornata con prepotenza ad occupare que- 
sto settore. La nuova linea di prodotti prende il nome di 
Turbo e vi appartengono Turbo C#, Turbo Delphi, e anche 
questo meraviglioso Turbo C++ per Windows. Compilatore 
ultraveloce dotato delle caratteristiche che da 
sempre hanno fatto grande i prodotti ^ 

Borland. Prima di tutto una forte 
attitudine all'uso dei "componen- 
ti", ve ne sono circa 200 inclusi in 
questo pacchetto e poi un' IDE 
straordinariamente ricco, affidabi- 
le e stracolmo di features che faci- 
litano la vita al programmatore. A 
fare da contorno a tutto questo 
un compilatore che produce codi- 
ce altamente ottimizzato e veloce. I 



Prodotti del mese 



PHP 5.2.0 

Il linguaggio di scripting del web 

Sono tre le colonne portanti di 
Internet: PHP, APACHE e MySQL 
Certo la concorrenza è forte. 
Asp.NET e SQL Server avanzano 
con celerità, ma a tutt'oggi non 
si può affermare che i siti svilup- 
pati in PHP costituiscano la stra- 
grande maggioranza di Internet. 
Quali sono le ragioni del succes- 
so di cotanto linguaggio? Prima 
di tutto la completezza. PHP ha 
di base tutto quello che serve ad 
un buon programmatore, rara- 
mente è necessario ricorrere a 
librerie esterne, e quando è pro- 
prio indispensabile farlo esistono 
comunque una serie di reposi- 
tory che rendono tutto immedia- 
tamente disponibile ed in forma 
gratuita. Il secondo punto di 
forza sta nella sua capacità di 
poter essere utilizzato sia in 
modo procedurale che nella sua 
forma ad oggetti certamente più 
completa e funzionale 
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Phalanger 2.0 

PHP in tecnologia .NET 

Ok, siete dei programmatori PHP 
ma vorreste che il vostro sito 
girasse in tecnologia .NET. 
Sapete che il miglio modo per 
far girare un sito sotto US sfrut- 
tandone tutte le potenzialità è 
scrivere codice .NET. Come fate? 
Facile! La soluzione esiste e si 
chiama Phalanger. Scrivete il 
vostro codice in PHP ma in realtà 
ottenete una pagina compilata 
in .NET. E' necessario installare 
qualcosa sul server, ma i risultati 
sono entusiasmanti! 
Certo c'è da installare qualcosa 
sul server e ancora il supporto 
non è completo tuttavia si tratta 
di una tecnologia da sperimen- 
tare sia per le prestazioni che è 
possibile ottenere sia per le 
opzioni di sicurezza con cui è 
possibile blindare l'applicazione 
potendo sfruttare a pieno tutti i 
meccanismi di protezione di US 
che sicuramente sono raffinati 
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Ruby 1.8.5 



Il vero nuovo che avanza 

In America è il linguaggio che mag- 
giormente ha scalato i vertici delle 
classifiche di utilizzo nell'ultimo an- 
no. In Italia sta giungendo rapida- 
mente come un ciclone a fare capo- 
lino nel panorama dello sviluppo. 
Bello, elegante, con una curva di ap- 
prendimento praticamente nulla, si 
tratta di un linguaggio di scripting 
che ottimamente si presta ad essere 
utilizzato sia sul Web sia in modo 
standalone. Recentemente ce ne sia- 
mo occupati in un bell'articolo di Pao- 
lo Perrotta, che mostrava come uti- 
lizzarlo per programmare un plugin 
per Skype messenger. Il linguaggio 
è elegante e raffinato, fa un uso in- 
tensivo delle liste, ma anche della 
programmazione ad oggetti. Si pre- 
sta bene allo sviluppo di qualunque 
tipo di applicazione e recentemen- 
re proprio un framework basato su 
Ruby: RubyOnRails ha vinto il pre- 
mio come miglior framework per lo 
sviluppo web 
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Nemerle 0.9.3 

L'emergente simile al C# 

Di tanto in tanto in programmazio- 
ne arrivano delle novità assolute 
che inizialmente sfuggono al gran- 
de pubblico per poi diffondersi len- 
tamente nel corso del tempo ed 
arrivare alla piena maturità in un 
periodo di tempo abbastanza 
lungo. E' stato il caso di Ruby molti 
anni fa e di Python ancora prima. 
E' il caso di Boo e di Nemerle ades- 
so. Nemerle è un linguaggio nato 
per la piattaforma .NET con una 
sintassi molto simile al C#. Si tratta 
di un linguaggio fortemente tipiz- 
zato ed orientato agli oggetti ma 
con la possibilità quando è il caso 
di essere utilizzato nella sua forma 
procedurale e da questo punto di 
vista segue i concetti cari al PHP. 
Altro aspetto interessante è quello 
di poter utilizzare le macro. Si trat- 
ta di un progetto interessante che 
merita una particolare attenzione. 
Nonostante la sua giovane età 
dispone di caratteristiche uniche 
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I contenuti del libro 



Programmare Office 2007 



v. 



Finalmente ci siamo Office 2007 è alle porte con il suo 
ricco carico di novità. Si tratta della suite più usata in 
ufficio e che in molti casi sostiene l'intera procedura 
di automazione aziendale. Certo, in molti la utilizzano al 
minimo delle potenzialità, tuttavia Office 2007 è molto di 
più di un semplice editor, un database e un foglio elettroni- 
co. Si tratta di un vero insieme di programmi che comuni- 
cano e interagiscono fra loro. Dall'archiviazione dei dati alla 
produzione dei documenti tutto può essere automatizzato 
con questa Suite, e quando le normali funzioni non bastano 
ecco intervenire Visual Basic for Application. Un linguaggio 
completo che consente di estendere e personalizzare tutti 
gli elementi che compongono questa suite secondo le esi- 
genze che caratterizzano le varie aziende o il singolo indivi- 
duo. Conoscere le tecniche di programmazione alla base di 
Office significa aumentrae di molto la propria produttività 
individuale e il processo di produzione dell'azienda 



IMPARA COME RENDERE PIÙ VELOCE IL 
TUO LAVORO IN UFFICIO PERSONALIZZANDO 

LA SUITE PIÙ USATA AL MONDO 

• Introduzione al Visual Basic for 
Application 

• YBA e finestre grafiche 

• L'architettura di Office 

• Ribbon e altre novità 
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GLI ALLEGATI DI I0PR0GRAMM0 

Questo mese vi presentiamo tre Webcast sul nascituro 
Windows Vista e sul nuovo .NET Framework 3.0 

Windows Vista e .NET Framework 3.0: overview 

Questo Webcast illustra le novità di Windows Vista per gli sviluppatori, con 
l'obiettivo di fornire una panoramica del nuovo sistema operativo 
e Framework di Microsoft. 
Speaker: Fabio Santini 

Architettura del sistema operativo 

Windows Vista è l'ultima versione della famiglia dei sistemi operativi derivata da 
Windows NT e, dal punto di vista architetturale, presenta il maggior numero di 
cambiamenti rispetto alle precedenti. Spesso le novità non influiscono sul com- 
portamento delle applicazioni finali , ma sono importanti per aumentare il livel- 
lo di sicurezza e di prestazioni del sistema. Windows Vista offre inoltre nuove e 
interessanti funzionalità alle applicazioni scritte per supportare questa versione 
del sistema operativo. 
Speaker: Marco Russo 

Il nuovo supporto per gli RSS 

RSS (Really Simple Syndication) è un formato XML molto comodo per descrive- 
re news, annunci e contenuti dinamici. Sempre più aziende e siti Web stanno 
adottando questo formato per pubblicare e consentire il monitoraggio dei loro 
siti Internet. Windows Vista, Internet Explorer 7 e Outlook 2007 supportano RSS 
nativamente. Microsoft permette inoltre di sviluppare applicazioni integrate con 
RSS mediante Windows RSS Platform. In questo Webcast vedremo sia i principi 
base di RSS sia le funzionalità di Windows RSS Platform. 
Speaker: Paolo Pia torsi 




FAQ 



Cosa sono i Webcast MSDN? 

MSDN propone agli sviluppatori una serie di eventi gratuiti 
online e interattivi che approfondiscono le principali temati- 
che relative allo sviluppo di applicazioni su tecnologia 
Microsoft. Questa serie di "corsi" sono noti con il nome di 
Webcast MSDN 

Come è composto tipicamente un Webcast? 

Normalmente vengono illustrate una serie di Slide commenta- 
te da un relatore. A supporto di queste presentazioni vengono 
inserite delle Demo in presa diretta che mostrano dal vivo 
come usare gli strumenti oggetto del Webcast 

Come mai trovo riferimenti a chat o a strumenti 
che non ho disponibili nei WebCast allegati alla 
rivista? 

La natura dei WebCast è quella di essere seguiti OnLine in 
tempo reale. Durante queste presentazioni in diretta vengono 
utilizzati strumenti molto simili a quelli della formazione a 
distanza. In questa ottica è possibile porre domande in presa 
diretta al relatore oppure partecipare a sondaggi etc. I 
WebCast riprodotti nel CD di ioProgrammo, pur non perdendo 



nessun contenuto informativo, per la natura asincrona del sup- 
porto non possono godere dell'interazione diretta con il rela- 
tore. 

Come mai trovo i WebCast su ioProgrammo 

Come sempre ioProgrammo cerca di fornire un servizio ai pro- 
grammatori italiani. Abbiamo pensato che poter usufruire dei 
Webcast MSDN direttamente da CD rappresentasse un ottimo 
modo di formarsi comodamente a casa e nei tempi desiderati. 
Lo scopo tanto di ioProgrammo, quanto di Microsoft è infatti 
quello di supportare la comunità dei programmatori italiani 
con tutti gli strumenti possibili. 

Su ioProgrammo troverò tutti WebCast 
di Microsoft? 

Ne troverai sicuramente una buona parte, tuttavia per loro 
natura i webcast di Microsoft vengono diffusi anche OnLine e 
possono essere seguiti previa iscrizione. L'indirizzo per saperne 
di più è: http://www.microsoft.it/msdn/webcast/msdn segnalo 
nei tuoi bookmark. Non puoi mancare. 

L'iniziativa sarà ripetuta sui prossimi numeri? 

Sicuramente si. 
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Online con "fiscali Easy 

Numero unico per tutta l'Italia e nessuna registrazione. Il modo 
più semplice e veloce per entrare in Internet risparmiando 



Sei spesso lontano da casa e hai necessità di 
collegarti a Internet ovunque ti trovi? 
Desideri salvaguardare la tua privacy navigan- 
do in modo anonimo? Non hai voglia di perde- 
re tempo in lunghe registrazioni per creare un 
nuovo account? Niente paura, Tiscali ha pensa- 
to anche a te! Con Tiscali Easy arriva un siste- 
ma tutto nuovo di collegarsi a Internet. Non 
sarà più necessario creare un nuovo account e 
fornire i propri dati personali, potrai navigare 
collegandoti con un unico numero di telefono 
(7023456789) da tutta Italia e soprattutto utiliz- 
zando i dati di accesso forniti direttamente da 
Tiscali (UserID e Password presenti sulla sche- 
da), quindi non collegabili in alcun modo a te. 
Insomma, con Tiscali Easy, otterrai in un colpo 
solo riservatezza dei dati, risparmio del tempo 
necessario alla creazione di un abbonamento e 
tariffe vantaggiose. I costi di connessione sono 
simili a quelli di un classico abbonamento gra- 
tuito: 1,90 cent, per i primi 10 minuti e 1,72 
cent, per quelli successivi. Per risparmiare 
ulteriormente è possibile connettersi a 
Internet durante le ore serali o nei giorni festi- 



TISCALI EASY 

C'È UN MODO NUOVO, SEMPLICE E VELOCE PER ENTRARE IN INTERNET. PROVALO SUBITO! 

_^^^^^^^^^ Crea una nuova connessione inserendo il numero 

unico di accesso da tutta Italia 7023456789 

Avvia la connessione e digita i seguenti codici: 

UserID master2007 
Password tiscali 

Grazie per aver scelto Tiscali 
e buona navigazione! 

Costi di connessione disponibili su tiscali.it 
Servizio di Assistenza dedicato 166614161 




30€8fflH 



tiscali» 

INTERNET WITH A PASSION. 



vi al costo di 1,09 cent, per i primi dieci minuti 
e 0,98 cent, per quelli successivi. L'unico requi- 
sito richiesto per poter eseguire la connessione 
è un modem correttamente installato. Poiché 
si tratta di una normale connessione analogica 
è possibile utilizzare i tool di accesso remoto 
integrati in Windows 



IN RETE CON TISCALI 



Nessuna registrazione basta creare una nuova connessione e inserire 
i dati di accesso forniti da Tiscali 




^ Installa un. 



j Avva la Qsaaone guidata 
Firewall 



Vedere anche 

ij Risoluzione dei problemi di 



* 



■fi VMnetS 



■InetS 
JÌ Connesso, 



Q NUOVA CONNESSIONE 
Portiamoci nel pannello di con- 
trollo, e selezioniamo l'icona connes- 
sioni di rete. In alto a sinistra sele- 
zioniamo "nuova connessione" e 
prepariamoci a seguire il wizard che 
comparirà 




Irnm^'-r»- i É i li Cui l'ini i-F i- 1-ifHah -fa "fJ t' ri*i,if- il .ili II 

ir fi I II I H I 1 I 11 I 3 ! ' r >- I [r h Ut ! (. \Ì>- I \ Il i 

i-oric stale dimenticate contattale ! - r: 



Conferma password 
Imposta questa 



II 



BDATI DI ACCESSO 
Seguiamo il Wizard fino a 
quando non ci vengono chiesti i 
dati per l'autenticazione. E' suffi- 
ciente inserire quelli presenti nella 
card allegata a questo numero di 
ioProgrammo: master2007/tiscali 




H ACCESSO A INTERNET 
Connettersi è semplicissimo, 
troveremo una nuova icona all'in- 
terno del pannello di controllo alla 
voce connessioni. Bastano due click 
ed il gioco è fatto sarete connessi 
ovunque vi troviate 
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SQL SERVER 
VS ORACLE: 
È GUERRA! 

Il fuoco alle polveri lo ha dato un re- 
cente studio condotto da NGSS - Next 
Generation Security Software, reso re- 
centemente noto all'indirizzo 
http://www.databasesecurity.com/db- 
sec/comparison.pdf. Lo studio ha preso 
in considerazioni le patch rilasciate per i 
due noti database nel corso degli ultimi 
6 anni. La palma del vincitore è andato 
a MS SQL Server che avrebbe rilasciato 59 
patch contro le 233 del database di Ora- 
cle che addirittura avrebbe ancora 49 fal- 




le aperte nel proprio sistema. Gli analisti 
non si sono dimostrati molto propensi a 
dare fiducia a questo rapporto conte- 
stando che SQL Server ha solo recente- 
mente conquistato fette di mercato ri- 
levanti e che non si sono considerate a suf- 
ficienza le falle relative al SQL Injection 
sul database di Microsoft. I portavoce di 
Oracle si sono limitati ad affermare che 
la ricerca è stata troppo semplicistica e 
che il livello di sicurezza andrebbe mi- 
surato anche in base agli effettivi sce- 
nari d'uso e agli ambienti in cui i siste- 
mi sono installati 

GRATIS LA GUI DI 
OFFICE 2007 

libbon, questo è il nome con cui Mi- 
crosoft identifica l'interfaccia grafi- 
ca di Office 2007. Gli sviluppatori che vo- 
lessero creare applicazioni con il look & 
feel di Ribbon potranno farlo a patto di 
rispettare la voluminosa licenza gratui- 
ta di appena 120 pagine con cui Microsoft 
certificherà le cose che si possono e non 
si possono fare. In questo modo da un 
lato MS protegge proprio lavoro, dal- 
l'altro stimola gli utenti a creare inter- 
facce omogenee sia fra di loro sia con il 
sistema operativo evitando la nascita di 
GUI ibride. 



PACE FATTA FRA 
MICROSOFT E NOVELL 



Per lungo tempo sono stati rivali, 
impegnati in più di una causa lega- 
le relativa alla reciproca infrazione di 
più di un brevetto. Improvvisamente 
tutto è cambiato. Microsoft e Novell 
hanno raggiunto un accordo per la 
cooperazione e l'interoperabilità. I ter- 
mimi dell'accordo sembrano a prima 
vista abbastanza semplici. In realtà ad 
uno sguardo più approfondito emerge 
qualche insidia che ha preoccupato 
non poco la comunità OpenSource. 
D'altra parte un segmento degli utiliz- 
zatori di Linux si è dichiarata entusia- 
sta. Questo equilibrio di posizioni 
mostra quanto in realtà ci si muova su 
una linea sottile che rende lo storico 
accordo sufficientemente complesso. 
In sostanza Microsoft consiglierà SuSE 
Linux a tutte quelle aziende che fanno 
uso di soluzioni miste. Allo stesso 
modo MS garantirà il supporto a tutti e 



due i sistemi operativi. La parte del 
leone la farà la virtualizzazione, 
Microsoft certificherà che i sistemi 
SuSE possano girare in modo virtualiz- 
zato in ambiente Windows, lo stesso 
farà SuSE nei riguardi dei sistemi ope- 
rativi prodotti dalla casa di Redmond. 
Una seconda parte dell'accordo preve- 
de la reciproca protezione legale. 
Ovvero le due parti si impegnano a 
non intraprendere azioni legali l'una 
nei confronti dell'altra in relazione a 
presunte infrazioni su alcuni brevetti. 
Una terza parte prevede la creazione di 
laboratori congiunti attraverso i quali 
si possano sviluppare tecnologie che 
innalzino la qualità della collaborazio- 
ne fra i due ambienti. Certamente que- 
sto accordo portata una ventata d'aria 
nuova nel mercato dei server, dove 
fino ad ora era stata RedHat a detene- 
re le maggiori quote di mercato 



RUBY E PYTHON 
SEMPRE PIÙ IN ALTO 



TIOBE {http://www. 
tiobe.com I) ha appena 
pubblicato la consueta 
classifica dei linguaggi più 
gettonati del momento. 
Questa speciale "hit para- 
de" viene stilata sulla base 
di un elevato numero di 
parametri, fra cui la dispo- 
nibilità di esperti di un 
certo linguaggio, il numero 
di progetti disponibili, l'a- 
dozione in ambiti di gran- 
de rilievo. Si tratta ovvia- 
mente di una classifica che 
non rispetta dei canoni di 
oggettività incontestabili, 
tuttavia fornisce la misura 
di quanto un linguaggio 
stia incontrando i favori del 
mercato oppure no. E' un 
buon indice per chi neces- 



sita di un consiglio per ini- 
ziare o per le aziende che 
devono decidere in quale 
segmento dello sviluppo 
investire. Per Novembre 
2006 vede in testa Java che 
tuttavia fa registrare un 
1,87% in meno rispetto allo 
stesso periodo dell'anno 
scorso. A seguire C e C++ 
con il primo in netto calo e 
il secondo in crescita di 
appena un 1.25%. Sale in 
quarta posizione Visual 
Basic che guadagna addi- 
rittura un 1.89% rispetto 
all'anno precedente. Anche 
Python in netta crescita, 
con un +0.87% si posiziona 
in settima posizione 
rubando il posto addirittu- 
ra al blasonatissimo C#. A 



sorprendere più di tutti 
sono Ruby e D, rispettiva- 
mente in dodicesima e 
quattordicesima posizione 
con un incremento di otto 
posizioni per il primo e 
addirittura di tredici per il 
secondo! E' vero che que- 
sta classifica va letta e adat- 
tata anche secondo la pro- 
pria percezione del merca- 
to, tuttavia se può fornire 
un'indicazione appare evi- 
dente quanto i linguaggi di 
scripting multipiattaforma 
stiano velocemente con- 
quistando posizioni signifi- 
cative. Ad incidere su que- 
sta tendenza è probabil- 
mente la semplicità con cui 
questi linguaggi si integra- 
no nei diversi sistemi 
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ESPLORANDO IL .NET 
FRAMEWORK 3.0 

IL NUOVO MODELLO DI PROGRAMMAZIONE MANAGED PER WINDOWS. COMBINA 
LE CARATTERISTICHE DI .NET 2.0 CON LE NUOVE TECNOLOGIE PER LO SVILUPPO DI 
INTERFACCE GRAFICHE, COMUNICAZIONE DI RETE, E IL SUPPORTO DEI PROCESSI AZIENDALI. 




REQUISITI 



■ imi mii'ii'i ^m 

L~ media conoscenza del 
l .NET Framework 2.0 



Windows XP SP2, 
Windows Server 2003, 
Windows Vista; Visual 
Studio 2005 Standard o 
superiore; .NET 
Framework 3.0 
Runtime Components 
(già inclusi in Vista); 
Visual Studio 
Extensions for 
Windows Workflow 
Foundation, Visual 
Studio Extensions for 
Windows Presentation 
Foundation e Windows 
Communication 
Foundation. 



^^a^a^a^a 



Tempo di realizzazione 



Lo scopo di una qualsiasi software house è 
quello di rilasciare il miglior prodotto softwa- 
re possibile, e poi di mantenerlo apportando 
miglioramenti e nuove funzionalità, oltre a correg- 
gere gli errori ed i bug presenti in una versione pre- 
cedente dello stesso prodotto. Con .NET Framework 
1.1, 2.0, Microsoft ha seguito senza dubbio la strada 
dell'innovazione e del miglioramento rilasciando 
una piattaforma sempre più stabile e che aumenta 
proporzionalmente la produttività dello sviluppato- 
re Windows. .NET Framework 3.0 prosegue lungo la 
stessa strada apportando una notevole mole di 
novità, di nuove funzionalità, ed un ambiente di svi- 
luppo ancora più produttivo. La nuova release è 
stata annunciata nella sua veste definitiva da 
Microsoft lo scorso 1 1 Novembre. 
.NET 3.0 può essere pensato come ad un .NET 2.0 
con l'aggiunta delle estensioni dell'ex WinFX, e cioè 
Windows Communication Foundation, Windows 
Presentation Foundation, Windows Workflow 
Foundation Windows Cardspace. 
Mentre C# 3.0, ASRNET 3.0 e compagnia faranno 
parte invece di .NET 3.5, forse! 



ARCHITETTURA 
DI .NET 3.0 

.NET 3.0 è costruito al di sopra di .NET 2.0. La 
figura 1 mostra una vista di insieme della nuova 
architettura. 
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Fig. 1: Lo schema a blocchi dell'architettura 



I componenti che costituiscono .NET Framework 
3.0, si pongono al di sopra e funzionano in collabo- 
razione con il .NET framework 2.0. Ciò significa fra 
l'altro che le "vecchie" applicazioni scritte per .NET 
2.0 continueranno a funzionare senza alcuna modi- 
fica anche dopo aver installato il nuovo framework, 
ciò perché il CLR non ha subito alcuna modifica, 
così come sono rimaste invariate le librerie della 
Base Class Library. Nessuna paura di incompatibilità 
quindi. 

Sarà poi ancora possibile scrivere applicazioni che 
non passano attraverso le nuove funzioni di .NET 
3.0, ma che lavorano soltanto con .NET 2.0, oppure, 
soprattutto per i nostalgici, applicazioni native, che 
utilizzano direttamente l'interfaccia Win32. 
Molte parti del .NET Framework 2.0 saranno supera- 
te e sostituite dalle corrispondenti parti dedicate di 
.NET 3.0, come vedremo nei prossimi paragrafi, ma 
le tecnologie di .NET 2.0 rimangono una parte fon- 
damentale della nuova release. 



WINDOWS WORKFLOW 
FOUNDATION (WF) 

Un workflow è un concetto molto semplice: una 
sequenza di attività eseguite in un dato ordine. 
Windows Workflow Foundation (WF) fornisce una 
tecnologia comune alle applicazioni che hanno la 
necessità di implementare tale logica. Molte aziende 
ormai hanno un proprio processo di sviluppo, facil- 
mente pensabile come un workflow, e Microsoft ha 
pensato proprio a questo nel momento in cui ha 
deciso di introdurre WF in .NET 3.0. 
Tra l'altro anche altri software di Microsoft utilizza- 
no o utilizzeranno WF: Office System 2007 fa parte di 
questi. Dato che esistono e possono esistere decine, 
centinaia o migliaia di diversi workflow con altret- 
tanti diversi requisiti, realizzare una tecnologia 
come WF, che possa gestirli tutti, ha richiesto un 
certo sforzo di astrazione. La soluzione è stata quel- 
la di considerare il concetto più generale possibile di 
workflow. In tal modo un workflow di WF è un insie- 
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me di attività eseguite da un motore. Ogni attività è 
rappresentata da una classe che contiene il codice 
necessario ad eseguirla. Le attività possono così 
essere riutilizzate in workflow diversi. La figura 2 
mostra in maniera grafica tale concetto: 
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Fig. 2: esecuzione di un workflow 

Visual Studio con le estensioni per WF consente di 
creare un workflow in maniera grafica, e generare un 
corrispondente codice in un nuovo linguaggio di 
markup, XOML (Extensible Object Markup 
Language), oppure, se si preferisce direttamente in 
codice sorgente C#. 



WINDOWS 
COMMUNICATION 
FOUNDATION (WCF) 

Qualunque sia il tipo di applicazione da sviluppare, 
capita abbastanza di frequente, soprattutto in ambi- 
to enterprise, la necessità di stabilire una comunica- 
zione fra diverse applicazioni. 
Dopo anni in cui ogni attore del mondo IT cercava di 
imporre la propria tecnologia o il proprio software, 
tutti i maggiori protagonisti si sono messi d'accordo 
per cercare un protocollo comune. Ciò ha portato ad 
esempio alla nascita di SOAP, dei Web Service, ed alla 
possibilità di intercomunicazione fra piattaforme 
completamente differenti, basti pensare a J2EE e 
.NET che oggi parlano fra loro in maniera nettamen- 
te più semplificata rispetto a qualche anno fa. 
Microsoft, con Windows communication 
Foundation (WCF), in origine chiamato in codice 
Indigo, introduce una interfaccia di programmazio- 
ne comune per ogni tipo di comunicazione. In tal 
senso WCF potrà realizzare, da solo, quello che oggi 
fanno altre tecnologie, come i servizi web, asp.net, 
.NET Remoting, gli Enterprise Services e così via. 
In .NET 3.0 applicazioni che prima utilizzavano una 
o più delle precedenti tecnologie, potranno utilizza- 
re solo WCF, semplificando di molto il tutto. 



Windows Communication Foundation (WCF) è un 
runtime ed un insieme di API per creare sistemi che 
spediscono messaggi fra servizi e client, il messaggio 
è il concetto fondamentale. WCF può così essere uti- 
lizzato per creare applicazioni che comunicano con 
altre applicazioni sullo stesso sistema, oppure su 
sistemi diversi che risiedono altrove, tramite inter- 
net. La figura 3 mostra l'architettura di alto livello di 
WCF. 
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Fig. 3: L'architettura di WCF 



STALLAZIOME DI .NET 3.0 




È possibile installare .NET 
Framework 3.0 nei sistemi 
operativi seguenti: 

- Microsoft Windows 2003 Server 
Service Pack 1 (SP1) 

- Windows XP SP2 

Windows Vista viene fornito già 
con .NET 3.0, e dunque può già 
eseguire applicazioni .NET 3.0 
Enabled. Per gli altri sistemi 
operativi sono stati rilasciati i .NET 
3.0 Runtime Components (cioè il 
Redistributable Package), 
disponibile anche in italiano, basta 
cercarli su MSDN nella sezione 
download. 

Microsoft ha poi rilasciato il nuovo 
SDK di Windows, dedicato 
naturalmente a Windows Vista, e 
contenente naturalmente il .NET 
Framework 3.0 SDK. Si tenga 
presente che il solo SDK non è 
sufficiente ad eseguire applicazioni 



scritte in .NET 3.0, quindi i Runtime 
Components sono in ogni caso 
richiesti. 

Oltre a tali download sono poi 
disponibili due estensioni per 
Visual Studio 2005, vale a dire 
quella per il supporto di Windows 
Workflow Foundation e quella, 
ancora in CTP al momento 
dell'articolo, per sviluppare con 
WPF e WCF. 

Chi avesse già installato in 
precedenza una versione Beta, 
dovrà prima rimuoverla utilizzando 
l'apposito Uninstall Tool: 
http://www.microsoft.com/downlo 
ads/details.aspx?Familyld=AAE7FC 
63-D405-4E13-909F- 
E85AA9E66146&displaylang=en 
Per eseguire applicazioni scritte 
per .NET 3.0 è necessario installare 
il pacchetto .NET Framework 3.0 
Runtime Components, 
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I contratti definiscono i vari aspetti del sistema di 
messaggistica, come si può comunicare con esso, 
cioè quali operazioni si possono chiamare e quali 
parametri possono essere passati. 

Lo strato Service Runtime contiene i diversi beha- 
viour, cioè definisce il comportamento del servizio 
nelle varie situazioni possibili durante il suo ciclo di 
vita, quanti messaggi possono essere processati, 
cosa succede in caso di errore, come e quando i 
messaggi vengono processati e così via. 
Lo strato di messaging è composto da canali, cioè i 
componenti che processano i messaggi. Esistono 
due tipologie di canali, quelli di trasporto e quelli di 
protocollo: i primi si occupano della lettura e della 
scrittura dei messaggi sulla rete, i secondi dell'inter- 
pretazione dei protocolli di comunicazione. 
Ogni servizio è alla fin fine un programma, che può 
essere eseguito come una qualsiasi applicazione, 
oppure ospitato ed attivato da un'applicazione 
separata. Lo strato Activation and hosting si occupa 
di questo. 

WCF supporta diversi tipi di comunicazione a 
messaggi, per default tutte del tipo Request- 
Reply, ma con la possibilità naturalmente di uti- 
lizzarle in diverse maniere. Ad esempio, capita 
spesso che un client debba solo invocare un'ope- 
razione remota e non gli importa del risultato, 
quindi basta una semplice comunicazione One 
Way, altre volte è necessaria invece una infra- 
struttura in cui il servizio possa invocare una 
funzione del chiamante, e si ha la cosiddetta 
operazione Callback, o ancora possono essere 
necessarie comunicazioni con sottoscrizioni di 
eventi o di tipo publish-subscribe. WCF permet- 
te tutto ciò ed altro ancora. 

II concetto fondamentale di client che accede ed uti- 
lizza un servizio è mostrato in figura 4. 




host 
process 



SERVICE 



WCF 



host 
process 



Fig. 4: Client che utilizza un servizio con WCF 



WINDOWS 
CARDSPACE (WCS) 

Quando gli utenti di un'applicazione, sia essa 
Web, o Windows, accedono ad essa, si ha una 
sorta di trasferimento della loro identità digita- 
le, che può essere costituita dal loro nome 



utente, dalla password, o di altre informazioni 
ancora più sensibili, con conseguenti ed intui- 
bili problemi di sicurezza. 
Windows Cardspace, prima conosciuto come 
InfoCard, si occupa del trattamento delle 
diverse identità digitali degli utenti. 
Esso è un sistema per creare delle relazioni fra 
un sito web o un servizio ondine e l'utente. 
WCS fornisce un modo per permettere a tali 
servizi di richiedere le informazioni sull'uten- 
te, all'utente di essere sicuro dell'identità del 
sito, di gestire le informazioni per mezzo di 
card, e di inviarle a tali servizi, senza la neces- 
sità di tenere a mente decine di nomi utenti, di 
password, di codici di accesso e così via. Basta 
creare una nuova Card, dare un nome facil- 
mente associabile ad un dato servizio, e si 
potrà utilizzare questa per accedere al servizio 
stesso ogni volta che ce n'è bisogno. 
Dopo l'installazione di .NET 3.0, il pannello di 
controllo di Windows conterrà una nuova 
icona, Windows Cardspace appunto, dal quale 
gestire le proprie Card. La figura 5 mostra la 
schermata di creazione di una nuova identità. 




Fig. 5: Creazione di una Card per Windows Cardspace 



WINDOWS 
PRESENTATION 
FOUNDATION (WPF) 

Qualunque sia la complessità di un'applicazione, sia 
essa un'applicazione basata su Workflow, su Servizi, 
quello che l'utente vede e che spesso ritiene ancora 
più importante è l'interfaccia utente. Windows 
Presentation Foundation (WPF), in origine Avalon, è 
la tecnologia di .NET 3.0 destinata alla creazione di 
interface grafiche evolute e coerenti anche in diver- 
si ambienti, client e tecnologie. Molte applicazioni 
sono ormai accessibili sia come classiche applica- 
zioni Windows, ma anche fruibili da un browser, ed 
è quindi spesso necessario un doppio sforzo di svi- 
luppo e manutenzione dell'interfaccia grafica. WPF 
promette di rendere più facile la vita agli sviluppato- 
ri in tal senso, ed allo stesso tempo, offre una 
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immensa varietà di componenti grafici, con suppor- 
to per video, animazioni, grafica 2D e 3D e così via. 
WPF per certi versi soppianta, ma non sostituisce, 
Windows Forms 2.0, ancora presente. L'innovazione 
principale è forse quella di poter usare grafica vetto- 
riale, e creare contenuti più facilmente fruibili dagli 
utenti, su diverse piattaforme. Basti pensare al clas- 
sico problema del ridimensionamento di una fine- 
stra su monitor con diverse risoluzioni: con grafica 
vettoriale il problema non si pone. 
Tutto ciò che WPF promette è realizzabile grazie ad 
un nuovo linguaggio di markup, chiamato XAML 
(Extensible Application Markup Language), derivato 
da XML, con cui vengono costruiti e definiti i buil- 
ding block delle interfacce grafiche. Per esempio per 
creare una finestra con un singolo pulsante, basterà 
creare un file con il seguente contenuto XAML: 

<Window 

xmlns="http://schemas. microsoft.com/winfx/2006/xa 

ml/presentation"> 
<Button>Hello WPF!</Button> 
</Window> 

WPF interpreta e traduce gli elementi presenti nel 
codice XAML, in corrispondenti classi .NET. 
Naturalmente Visual Studio, tramite le estensioni 
dedicate a WPF, consente di creare XAML non solo 
scrivendo direttamente il codice XML, ma passando 
attraverso l'aggiornato designer dedicato ad esso. 
Creare una interfaccia utente utilizzando XAML ha 
diversi vantaggi rispetto alle tecnologie tradizionali: 
XAML è spesso molto più facile da leggere, ed 
espressivo quindi rispetto a del codice C#. XAML 
consente di separare la logica dell'applicazione dalla 
definizione dell'interfaccia grafica, e quindi consen- 
te un maggior riutilizzo del codice scritto oltre che 
una maggiore robustezza dell'insieme. Inoltre in tale 
maniera un grafico potrà lavorare all'interfaccia gra- 
fica, mentre uno sviluppatore si occupa del lato di 
logica. 



SVILUPPARE 
CON .NET 3.0 

Per installare e dotare la vostra macchina di ciò di 
cui si ha bisogno per sviluppare applicazioni per e 
con .NET Framework 3.0, date un'occhiata al box 
dedicato, in questo stesso articolo. Dopo aver instal- 
lato in particolare le estensioni per Visual Studio 
2005, fra i template disponibili per la creazione di un 
nuovo progetto saranno presenti sia quelli per la 
creazione di applicazioni WPF ed un template per la 
creazione di una libreria WCF al di sotto della cate- 
goria Visual C#, e sei nuovi template per la creazione 
di applicazioni WF raggruppati nella categoria 
Workflow (figura 6). 
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Fig. 6: i nuovi template per WPF, WCF, WF 



HELLO WORKFLOW 

Il primo passo nella creazione di un'applicazione 
WF, supponendo di aver già definito un workflow o 
di averne uno pronto da implementare, è la creazio- 
ne di un progetto Visual Studio. Dalla lista dei tem- 
plate disponibili (figura 7) dopo l'installazione delle 
estensioni per Windows Workflow, si selezioni il tipo 
Sequential Workflow Console Application, si assegni 
un nome al progetto, e poi si faccia clic su OK. 
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Fig. 7: creazione del progetto WF 

Il progetto conterrà un oggetto Workflowl.es, che 
può essere per il momento eliminato, perché ne 
verrà creato uno da zero. Facendo clic con il tasto 
destro quindi sul progetto nel Solution Explorer, si 
selezioni la voce Add->Sequential Workflow, e dalla 
schermata seguente (figura 8) il tipo Sequential 
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Fig. 8: aggiunta di un WF 
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Workflow (with code separation), dopo aver even- 
tualmente assegnato un nome al workflow, e fatto 
clic su Add, verrò creato un fileWorkflowl.xoml, che 
è il file contenente il codice di markup in linguaggio 
xoml, ed un file Workflowl.xoml.es, contenente il 
code beside dello stesso Workflow. 
Nel designer di Visual Studio il Workflow sarà visua- 
lizzato in maniera grafica, e dalla toolbox si potrà 
trascinare un elemento Code per creare una prima 
attività per il nostro processo (figura 9). 




Fig. 9: Creare un'attività dei Workflow 

Come si noterà dalla figura, la prima attività è con- 
trassegnata da un punto esclamativo, facendo clic 
su di esso si verrà avvisati che per l'attività stessa 
non è impostata la proprietà ExecuteCode, cioè non 
è stato definito il codice che descrive l'attività da 
eseguire. In questo caso basta fare doppio clic sul- 
l'attività, o impostare la proprietà dalla finestra 
Properties del Solution Explorer. 

private void codeActivityl_ExecuteCode(object 

sender, EventArgs e) 

{ 

CodeActivity e = (CodeActivity)sender; 
Console. WriteLine("Hello, da '{0}'.\nSono 

un'istanza della classe {1}.", 
c.Name, c.GetType().ToString()); 
T~ 

Il codice precedente farà stampare sulla console 
una stringa "Hello", seguita dal nome dell'attività e 
dal tipo, quando il motore di WF eseguirà l'attività 



I HA INCASTRATO WIIUFX 



La numerazione 3.0 può ingannare 
chi non ha seguito le ultime 
vicende pre-rilascio della 
piattaforma, che in origine era 
stata battezzata con il più esotico 
nome WinFX, e poi, nonostante le 
proteste provenienti da diverse 
parti, cambiata in .NET 3.0. Il nome 



.NET 3.0 lascerebbe infatti pensare 
ad una nuova versione del CLR, 
quindi ad un nuovo compilatore, e 
magari all'inclusione in tale rilascio 
delle caratteristiche di C# 3.0, di 
ASP.NET 3.0 o di un nuovo VB.NET. 
Niente di tutto questo, .NET 3.0 è in 
realtà una sorta di .NET 2.5. 



stessa. Per effettuare il debug del primo Workflow 
basta come al solito premere il tasto F5. Prima si 
imposti però un breakpoint sull'attività, premendo 
il tasto F9 (o dal menù contestuale Breakpoint- 
>Insert Breakpoint) dopo averla selezionata nel 
designer, dovrebbe apparire un pallino rosso sul 
bordo sinistro. Avviato il debug verrà create un'i- 
stanza del Workflow, ed il runtime di Workflow 
Foundation prowederà ad avviarla. Andando a 
vedere il codice presente nel metodo Main del file 
Program.cs, si noterà infatti il seguente: 

Workflowlnstance instance = 
workflowRuntime.CreateWorkflow(typeof(HelloWorkfl 

ow. Workflow)); 
instance. Sta rt(); 

In debug l'esecuzione si fermerà appena il Workflow 
dovrà eseguire la codeActivityl, e questa apparirà 
evidenziata in giallo, allo stesso modo in cui Visual 
Studio evidenzia il sorgente ad un breakpoint sul 
codice. Continuando l'esecuzione, sulla console 
verrà stampata la stringa suddetta, dopodiché il 
Workflow terminerà. 



CONTROLLO DEL FLUSSO 

Adesso si proverà a complicare un po' il processo, in 
maniera da vedere come eseguire una attività od 
una seconda in base ad una determinata condizio- 
ne, vale a dire come modellare un classico if/else. 
Per aggiungere un blocco if/else basta trascinare sul 
designer del Workflow, un'attività IfElse su uno dei 
rami in cui è visualizzato un simbolo +. Il blocco 
IfElse ha per default due soli rami, ma si possono 
anche creare più rami semplicemente facendo clic 
sulla voce Add Branch del menù contestuale del 
blocco. Per abilitare l'esecuzione di un ramo dovrà 
essere soddisfatta una data condizione, che puà 
essere specificata in due diversi modi: via codice o 
tramite un'espressione che restituisce un valore 
booleano. In questo esempio si utilizzerà un'espres- 
sione. Si supponga di voler eseguire il ramo a sini- 
stra nel caso in cui l'utente sia un nuovo cliente, per 
esempio per consentirne la registrazione su un sito, 
mentre quello a destra sarà solo per gli utenti regi- 
strati, e quindi per effettuare il login (vedi figura 10). 
Aggiungiamo intanto alla classe un campo boolea- 
no e la corrispondente proprietà di accesso, che ser- 
virà ad indicare se un utente è registrato o meno: 



private bool m_newllser; 


public 


bool IsNewUser 




{ 


get { return m_newUser; } 




set { m_newUser = 


= value; } 


} 
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Fig. 10: Controllo del flusso delle attività 

Per impostare la condizione su un ramo, si faccia clic 
su di esso, poi nella finestra delle proprietà su 
Condition, scegliendo in questo caso la tipologia 
Declarative Rule Condition. Adesso bisogna asse- 
gnare prima un nome alla condizione, per esempio 
NewUser, e poi costruire l'espressione booleana uti- 
lizzando il Rules Condition Editor (figura 11). Per 
avviarlo basta fare clic sui tre puntini nel campo 
Expression. 



Edit consttairts tu create a rute condition, 
Exampse: fchis PropI ■■ "Yes" II this.Prop? ■■ 



(User == True 



[riitiateePropertie:" 

Is6inding5et 

IsDynamo 



Fig. 11: Definizione di una regola per WF 

Nell'esempio basterà verificare che la proprietà 
IsNewUser è true, per eseguire il ramo di registrazio- 
ne. Nel caso contrario verrà naturalmente eseguito 
l'altro ramo. 

Nei due rami basterà poi creare le due attività esclu- 
sive da eseguire, ed impostare le relative proprietà 
ExecuteCode, in questo caso si stamperanno solo 
delle stringhe per verificare che il flusso è quello cor- 
retto: 

private void registrationActivity_ExecuteCode(object 

sender, EventArgs e) 

{ 

Console. Writel_ine("Procedura di registrazione"); 

} 

private void loginActivity_ExecuteCode(object sender, 

EventArgs e) 

{ 

Console. Writel_ine("Procedura di login"); 

T~ 

Non resta che aggiungere del codice per far sceglie- 
re all'utente se vuole registrarsi o effettuare il login, 
nella prima attività, impostare la variabile 
m_newUser, ed il gioco, oops, il workflow è fatto. 



private void codeActivityl_ExecuteCode(object 

sender, EventArgs e) 

{ 

Console. Writel_ine("Sei un utente registrato? 

(s/n)"); 

if (Console. ReadLineQ == "s") 



_newllser = true; 



else m_newllser = false; 



CREARE SERVIZI 
E CLIENT WCF 

Dopo averne parlato in maniera teorica e architettu- 
rale si affronterà ora l'implementazione di un'appli- 
cazione WCF, a partire dalla creazione del servizio 
completo, inclusa la sua definizione, la codifica, e 
l'hosting. Il primo passo è in genere la definizione 
dei contratti e poi implementarli. 
Si supponga di voler realizzare un servizio per una 
pizzeria, a cui un cliente può richiedere l'elenco 
delle pizze disponibili con i relativi prezzi. Il primo 
passo sarà quello di rappresentare una pizza, con 
una classe. 

Da Visual Studio 2005, si crei innanzitutto un nuovo 
progetto, scegliendo come tipologia WCF Service 
Library, ed assegnando un nome adeguato: per 
esempio PizzaWCFServiceLibrary. Visual Studio 
2005 creerà il progetto ed un file Class l.cs, conte- 
nente una serie di informazioni utili. In testa al file 
sarà presente un commento che spiega come utiliz- 
zare il servizio della libreria che si sta implementan- 
do in un'altra applicazione. Suggerisco di leggerlo 
per comprendere meglio il funzionamento del tutto. 
Il file Class l.cs conterrà poi un'interfaccia, e due 
classi. 



[ServiceContractQ] 



public interface IServicel 



{ 



[OperationContract] 



string MyOperationl(string myValue); 



[OperationContract] 



string MyOperation2(DataContractl 

dataContractValue); 



public class servicel : IServicel 



{ 



public string MyOperationl(string myValue) 



{ 



return "Hello: " + myValue; 



} 



public string MyOperation2(DataContractl 

dataContractValue) 



{ 




return "Hello: " + 
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dataContractValue.FirstName; 



[DataContract] 



public class DataContractl 



{ 



string firstName; 



string lastName; 



[DataMember] 



public string FirstName 



{ 



get { return firstName; > 



set { firstName = value; } 



> 



[DataMember] 



public string LastName 



{ 



get { return lastName; > 



set { lastName = value; } 



} 



La classe IServicel rappresenta l'interfaccia del ser- 
vizio, cioè le operazioni che esso esporrà al client, in 
questo caso MyOperationl e MyOperation2. 
L'attributo ServiceContract indica proprio che si 
tratta di un contratto di servizio WCF. 
La classe servicel implementa l'interfaccia prece- 
dente. 

Infine la classe DataContractl rappresenta un con- 
tratto di dati. L'attributo DataContract indica che la 
classe implementa un contratto di dati, che potran- 
no dunque essere serializzati e scambiati fra servizio 
e client. 

Naturalmente tali classi e interfacce saranno ora 
sostituite da quelle necessarie all'implementazione 
del servizio della pizzeria. 

Prima di andare ad implementare il servizio si noti 
anche la presenza di due using fondamentali in 
qualsiasi servizio WCF: 

using System. ServiceModel; 

using System. Runtime.Serialization; 

Il file class l.cs può anche essere eliminato. Si 
aggiunga poi una nuova classe, chiamandola Pizza. 
La classe sarà marcata con l'attributo 
DataContract, i membri della classe che saranno 
esposti dal servizio dovranno essere marcati invece 
con DataMember: 



[DataMember] 


public string Name; 


[DataMember] 


public decimai Price; 


[DataMember] 


public string[] Ingredients; 


} 



Per semplicità e comodità si aggiunga un costrutto- 
re per inizializzare una pizza in maniera appropria- 
ta: 



public Pizza(string name, decimai price, 


string[] 

ingredients) 


{ 


Pizzald = Guid.NewGuid(); 


Name = name; 


Price = price; 


Ingredients = ingredients; 


} 



Con questo abbiamo creato il contratto strutturale 
del servizio, cioè i messaggi scambiati fra servizio e 
client. Adesso si implementerà invece il comporta- 
mento, quindi i contratti di behavior, tramite un'in- 
terfaccia marcata dall'attributo ServiceContract. 
Da Visual Studio 2005 basta fare clic con il destro sul 
progetto, scegliere Add Item e poi Interface come 
tipo di elemento da aggiungere. Il nome della nuova 
interfaccia del servizio sarà IPizzaService, si noti 
anche la presenza del parametro Namespace per 
definire uno spazio dei nomi unico per il servizio: 



using System. ServiceModel; 



namespace PizzaWCFServiceLibrary 



{ 



[ServiceContract(Namespace = 

"http ://IoProgrammo. Services")] 



interface IPizzaService 



{ 



} 



A questo punto si può aggiungere una operazione al 
servizio, per esempio quella per ottenere il listino 
delle pizze. L'attributo OperationContract indica 
proprio che si tratta di un'operazione facente parte 
del contratto del servizio. 

[OperationContract] 
List<Pizza> GetListinoPizzeQ; 



[DataContract] 



public class Pizza 



{ 



[DataMember] 



public Guid Pizzald; 



Non resta che implementare la logica del servizio. Si 
aggiunga al progetto una classe pubblica 
PizzaService che implementi l'interfaccia 
IPizzaService. In questo caso, dato che non fa parte 
dello scopo dell'articolo, il listino di pizze sarà cabla- 
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to nel codice, mentre per un'applicazione reale esso 
sarà magari letto da un database come SQL Server. 

[ServiceBehavior(InstanceContextMode=InstanceCont 

extMode.PerCall)] 
public class PizzaService:IPizzaService 



private List<Pizza> pizze; 



public PizzaServiceQ 



{ 



pizze = new List< Pizza >(); 



pizze. Add(new Pizza("margherita", 3.0M, 
new string[] { "mozzarella", "pomodoro" })); 

pizze. Add(new Pizza("prosciutto", 3.0M, 
new string[] { "mozzarella", "pomodoro", "prosciutto" 

m 

pizze. Add(new Pizza("capricciosa", 3.0M, 
new string[] { "mozzarella", "pomodoro", 
"prosciutto", "wurstel", "olive", "carciofini", "funghi" 



»); 



public List<Pizza> GetListinoPizze() 

{ 

return pizze; 



> 



Per mezzo dell'attributo applicato alla classe, ed in 
particolare del parametro InstanceContextMode si è 
indicato che il servizio verrà istanziato ad ogni chia- 
mata. 

Adesso il servizio è pronto per l'uso, non resta che 
creare un'applicazione client da cui creare un'istan- 
za del servizio e poi configurare il protocollo di 
comunicazione utilizzato dal servizio stesso. Per 
farlo si utilizzerà un tool fornito con il nuovo SDK di 
Windows, il Service Configuration Editor, awiabile 
sia dal menù Start di Windows, o più comodamente 
dal menù Tools di Visual Studio 2005. 
Dopo aver creato un altro progetto per un'applica- 
zione Console, si aggiunga il file di configurazione 
dell'applicazione App.config, e lo si apra dal Service 
Configuration Editor. Dall'albero a sinistra si selezio- 
ni il nodo Advanced, poi Service Behavior e si faccia 
clic su New Service Behavior Configuration dal pan- 
nello Task. 

Si nomini la configurazione MetadataBehavior nel 
pannello Behavior e poi si faccia clic sul pulsante 
Add. Si scelga l'elemento serviceMetadata e lo si 
aggiunga ancora con Add. 

L'elemento creato verrà aggiunto sotto il nodo 
MetadataBehavior dell'albero a sinistra, lo si selezio- 
ni con il mouse per configurarlo e poi per utilizzare 
il protocollo http si cambi la proprietà 
HttpGetEnabled a true. 

Ora è possibile aggiungere il servizio PizzaService 
alla configurazione. Nel pannello Tasks si faccia clic 



sul link Create a New Service, quando viene richiesto 
il Service Type si faccia clic sul pulsante Browse per 
cercare l'assembly precedentemente creato, 
PizzaWCFServiceLibrary.dll, che si troverà nella 
directory bin del progetto WCF Library. Nel passo 
successivo sarà richiesta l'interfaccia da utilizzare ed 
in questo caso l'unica selezionabile sarà la 
IPizzaService, mentre come tipo di comunicazione 
si dovrà scegliere http. 

Nel passo seguente si lasci selezionato il valore di 
default, Basic Web Services interoperability, e nel- 
l'ultimo passo, come indirizzo del servizio si specifi- 
chi: 

http://localhost:8081/IoProgrammo/PizzaService 

Nell'albero Configuration a sinistra si noterà ora la 
presenza del servizio creato, con un singolo 
EndPoint così come appena configurato (vedi figura 
12). 




Fig. 12: Configurazione di un servizio WCF 

Si selezioni il nodo del servizio PizzaService dall'al- 
bero, impostando il parametro Behavior 
Configuration al valore MetadataBehavior e si salvi il 
progetto dal menù File, con questo il tool può esse- 
re chiuso. 

Tornando a Visual Studio il file di configurazione 
App.config conterrà nuovi elementi con le modifi- 
che appena apportate: 

<behaviors> 

<serviceBehaviors> 

< behavior name="MetadataBehavior"> 
<serviceMetadata 

httpGetEnabled="true" /> 
</behavior> 
</serviceBehaviors> 
</behaviors> 
<services> 

<service behaviorConfiguration = "MetadataBehavior" 
name="PizzaWCFServicel_ibrary. PizzaService" > 
<endpoint 
address="http://localhost:8081/IoProgrammo 

/PizzaService" 
binding = "basicHttpBinding" 
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bindingConfiguration = 



contract="PizzaWCFServiceLibrary.IPizzaService" /> 
</service> 

Il passo finale è quello di ospitare il servizio in un 
application domain. 

Nel metodo Main dell'applicazione Console viene 
creato un oggetto ServiceHost che ospiterà il servi- 
zio PizzaService, all'indirizzo specificato come para- 
metro. 

static void Main() 

{ 

ServiceHost shPizzaService = new ServiceHost( 

typeof(PizzaService), new 

Uri("http://localhost:8081/IoProgrammo/")); 
shPizzaService. Open(); 
Console. Write("Premi un tasto per fermare il 

servizio"); 
Console. Read(); 
shPizzaService. Close(); 



Innanzitutto è necessaria un'applicazione client, 
quindi in un'altra soluzione di Visual Studio, si crei 
un progetto Applicazione Windows Forms, chia- 
mandolo ad esempio PizzaWCFClient, si crei il file di 
configurazione App.config e come dice la pagina di 
help, si lanci da un prompt dei comandi di Visual 
Studio il comando seguente, mentre il ServiceHost è 
ancora attivo, spostandosi nella cartella del nuovo 
progetto, contenente il file App.config: 

svcutil http://localhost:8081/IoProgrammo 

/out: PizzaServiceProxy.es /config:app.config 

/mergeconfig 

che creerà un file PizzaServiceProxy.es ed aggiornerà 
il file app.config esistente. Si aggiunga il file 
PizzaProxyService.es al progetto, e si verifichi che il 
file di configurazione sia stato aggiornato. 
Ora è possibile utilizzare la classe PizzaServiceClient 
in maniera piuttosto immediata, ottenere il listino 
delle pizze e magari mostrarlo in un controllo 
TreeView. 
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Il metodo Open mette il servizio in stato di esecu- 
zione e attesa. La chiamata a Console.Read successi- 
va serve a far rimanere il ServiceHost in questo stato, 
per permettere poi la chiusura alla pressione di un 
tasto. 

Mandando in esecuzione l'applicazione console, 
si apra un browser digitando l'indirizzo specifi- 
cato come Uri. Apparirà, se tutto funziona cor- 
rettamente una pagina come quella mostrata in 
figura 13, che spiega come creare un client ed 
utilizzare il servizio. 
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F/g. 13: La pagina descrittiva del servizio PizzaService 



Seguendo le istruzioni, si creerà un proxy del servi- 
zio, che un'applicazione qualunque potrà utilizzare 
per comunicare con il servizio vero e proprio. 



PizzaServiceClient client = new PizzaServiceClient(); 
Pizza[] pizze=client.Getl_istinoPizze(); 

La figura 14 mostra l'applicazione client in esecuzio- 
ne, il cui codice è naturalmente allegato all'articolo e 
può essere quindi provato sul proprio computer. 
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Fig. 14: L'applicazione client del servizio PizzaService 



IL MODELLO 
APPLICATIVO DI WPF 

Verrà ora affrontato lo sviluppo di un'applicazione 
WPF, cercando di dare una panoramica la più ampia 
possibile della nuova tecnologia di costruzione delle 
interfacce grafiche. 

Il modello applicativo di Windows Presentation 
Foundation distingue fra due tipi di applicazioni: 
standalone e browser. Un'applicazione del primo 
tipo mostra il contenuto grafico nelle classiche fine- 
stre, dialog, e message box, mentre un'applicazione 
browser è fatta da pagine mostrate in un browser 
(attenzione a non confonderle con le applicazioni 
asp.net). Di conseguenza, le applicazioni WPF pos- 
sono avere due stili di navigazione: tramite menu o 
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hyperlink. Non è necessario specificare che le appli- 
cazioni standalone supportano di default la naviga- 
zione a menù, mentre le applicazioni browser utiliz- 
zano i collegamenti ipertestuali. Il bello però è che 
WPF consente un approccio misto. 



INTRODUZIONE A XAML 

XAML è stato creato da Microsoft per interfacciare il 
.NET Framework con il sistema operativo Vista per 
mezzo del substrato di presentazione WPF. XAML da 
agli sviluppatori l'opportunità di controllare il layout 
di tutti gli elementi di un'interfaccia come caselle di 
testo, pulsanti, immagini e altro ancora, utilizzando 
una sorta di dialetto XML. 

Dato che ogni elemento XAML corrisponde ad una 
classe del CLR, tutto ciò che può essere fatto tramite 
XAML, può essere fatto via codice. 
Anche gli eventi ed i relativi gestori possono essere 
dichiarati come attributi XAML e poi implementati 
in C# oVB.net. 

XAML offre diversi benefici sia rispetto ad altri lin- 
guaggi di definizione delle interface, come XUL e 
HTML, ma anche rispetto alla tradizionale program- 
mazione in linguaggi di alto livello. Per esempio, per 
creare un pulsante in XAML con relative gestore del- 
l'evento Click, impostanto colore di background e 
testo si scriverà: 

<Button Click="OnClickHandler" Background="Green" 

Content="Invia" /> 

Per fare la stessa cosa in C# si dovrà scrivere: 

Button myBtn = new Button( ); 
myBtn. Background = Brushes. Green; 
myBtn. Text=" Invia "; 
myBtn. Click += new 

System. EventHandler(OnClickHandler); 

XAML non richiede altro che un editor di testo per 
essere scritto, ma naturalmente un IDE con intelli- 
sense e magari con designer visuale è molto più pro- 
duttivo. Le estensioni di Visual Studio per WPF con- 
sentono di scrivere codice XAML dall'IDE e di pro- 
gettare le interfacce in maniera visuale. 



APPLICAZIONI 
STANDALONE 

Per creare un'applicazione standalone con Visual 
Studio 2005, dotato delle estensioni WPF, si crei un 
progetto di tipo Windows Application, dando un 
nome a propria scelta, per esempio WinAppWPF. 
Visual Studio 2005, creerà due file XAML, App.xaml e 
Windowl.xaml, con i relativi file di code-behind, per 



esempio App.xaml.cs eWindowl.xaml.es. Il primo è 
il file che definisce l'intera applicazione. 
Ogni applicazione WPF infatti è un'istanza di 
System.Windows.Application, che può essere usata 
appunto da XAML, da codice o da una loro combi- 
nazione. 

L'applicazione appena creata da Visual Studio con- 
terrà il seguente XAML: 

< Application x:Class="WinAppWPF.App" 
xmlns= "http://schemas.microsoft.com/winfx/2006/xa 

ml/presentation" 
xmlns:x= "http://schemas.microsoft.com/winfx/2006/ 

xaml" 
Sta rtupllri= "Windowl.xaml" 
> 

< Application. Resources> 



</Application.Resources> 



</Application> 



Mentre dal lato codice si avrà: 



public partial class App : System.Windows.Application 



{ 



> 



Ma dove si trova il metodo Main? Non c'è, perché il 
punto di ingresso dell'applicazione è incapsulato 
dalla classe Application, e la proprietà StartupUri 
indica quale finestra utilizzare come interfaccia ini- 
ziale dell'applicazione, in questo caso 
Windowl.xaml. Il fatto che il file App.xaml e 
App.xaml.cs costituiscono il punto di partenza viene 
indicato a VS e quindi al compilatore tramite la fine- 
stra delle proprietà di VS. Come si può notare in figu- 
ra 15, dopo aver selezionato il file App.xaml, la pro- 
prietà Build Action è impostata ad 
ApplicationDefinition. Ciò farà in modo che dietro 
le quinte verrà generato il codice C# seguente: 

public static void Main() { 



WinAppWPF.App app 



new 

WinAppWPF.AppQ; 



app.InitializeComponent(); 



app.Run(); 



> 



Ma tutto ciò può tranquillamente essere ignorato 
dallo sviluppatore. 

L'altro file generato, Windowl.xaml, contiene la defi- 
nizione di una finestra, istanza in WPF della classe 
Window 

La proprietà Build Action per questo file è stavolta 
impostato al valore Page, e la finestra quindi può 
essere utilizzata dall'Application come finestra prin- 
cipale per mezzo del suo Uri, come visto in prece- 
denza. Visual Studio 2005 consente di editare 
manualmente il codice XAML, oppure di creare e 
modificare l'interfaccia grafica per mezzo del desi- 
gner (vedi figura 15) 
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Tramite il designer si possono utilizzare i controlli 
della ToolBox come ormai tutti gli sviluppatori 
Windows dovrebbero essere abituati a fare, trasci- 
nandoli su un contenitore della finestra. 
Il codice XAML della finestra generata da Visual 
Studio assomiglierà al seguente: 

<Window x:Class="WinAppWPF.Windowl" 
xmlns= "http://schemas.microsoft.com/winfx/2006/xa 

ml/presentation" 
xmlns:x= "http://schemas.microsoft.com/winfx/2006/ 

xaml" 
Title="WinAppWPF" Height="300" 
Width = "300" 

xmlns:my="clr- 
namespace:System;assembly=mscorlib" 
> 
<Grid> 
</Grid> 
</Window> 

Ogni finestra deve avere un contenitore in cui 
posizionare gli elementi di interfaccia. 
Microsoft, come si può notare, incoraggia l'uti- 
lizzo della classe Grid, per la flessibilità di posi- 
zionamento. 

Per aggiungere un pulsante alla finestra basta 
creare all'interno dell'elemento Grid un sot- 
toelemento Button, per esempio: 



<Grid> 




< Button 


Background=' 


AliceBlue" 






Foreground = 


"Black" 


Width = "100" 


Height="20" 


Content="Submit" 


Click="Button_Click" /> 


</Grid 


> 







Nel file di code-behind si andrà poi a implementare 
il gestore Button_Click: 

protected void Button_Click(object sender, 

RoutedEventArgs ev) 

{ 
MessageBox.Show("Ciao"); 



} 



APPLICAZIONI 
PER BROWSER 

Per creare un'applicazione browser, dall'elenco 
dei template di Visual Studio 2005 si scelga la 
tipologia XAML Browser Application. 
VS 2005 creerà ancora una volta una coppia di file 
App.xaml e App.xaml.cs per l'applicazione, ma sta- 
volta, piuttosto che una Window, creerà una Page, 
in quanto le applicazioni per browser saranno 
costituite da pagine piuttosto che da finestre. Il 
funzionamento di una Page è praticamente identi- 
co ad una Window, quindi è possibile aggiungervi 
un Button ed una Label come di seguito: 



<Page x 


:Class="XAMLBrowserApplication.Pagel" 


xmlns=' 


http://schemas.microsoft.com/winfx/2006/xa 
ml/presentation" 


xmlns:x 


= "http://schemas 


microsoft.com/winfx/2006/ 
xaml" 


Title= 


="Pagel" 




> 


<Grid> 



<Button Name="buttonl" Click="Buttonl_Click" 

Height="27" Margin = "0,0,8,8" 

VerticalAlignment="Bottom" 

HorizontalAlignment="Right" Width = "100"> 



Vai a pagina 2 


</Button> 


<Label Height="25" Margin = "120, 75, 145,0" 
Name= "label 1" VerticalAlignment="Top"> 


Contenuto della pagina 1 


</Label> 


</Grid> 


</Page> 



Si aggiunga poi un'altra pagina, facendo clic con 
il destro sul progetto, scegliendo Add dal menù 
contestuale, e selezionando il tipo Page dall'elen- 
co. Per spostarsi dalla Pagel alla Page2 come in 
una normale applicazione web, si utilizza la clas- 
se NavigationService ed il suo metodo Navigate. 

protected void Button l_Click(object sender, 

RoutedEventArgs ev) 

{ 

NavigationService. Navigate("page2. xaml"); 
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Oppure, utilizzando un controllo Hyperlink, 
basta impostare la proprietà NavigateUri: 

<Hyperlink NavigateUri = "page2.xaml">Vai a pagina 

2</Hyperlink> 

Avviando l'applicazione (a proposito, per abilita- 
re il debug di una applicazione per browser è 
necessario, nelle proprietà del progetto, sezione 
Debug, selezionare la voce Enable Unmanaged 
Code Debugging) si aprirà il browser Internet, 
con l'applicazione che verrà eseguita al suo 
interno, come mostrato in figura 16. 
Una bella novità introdotta con WPF, è la possibi- 



File Edit View Vaia Pc 
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j Risorse del computer 



Fig. 16: Una browser application in esecuzione 

lità di creare applicazioni ibride, sfruttando il 
concetto di navigazione anche in una normale 
applicazione. Basta utilizzare un oggetto 
NavigationWindow: 

<NavigationWindow ... Source="Pagel.xaml" /> 

Una possibile applicazione reale di Navigation 
Window potrebbe essere la realizzazione di un 
Wizard. 



il controllo TreeView, contenente le pizze ricava- 
te dal servizio PizzaService. 
Se la finestra Window 1 è così definita in XAML: 

< Window x:Class="WPF_Hosts_Winforms.Windowl" 
xmlns= "http://schemas.microsoft.com/winfx/2006/xa 

ml/presentation" 
xmlns:x= "http://schemas.microsoft.com/winfx/2006/ 

xaml" 
Title="WPF_Hosts_Winforms" Height="300" 

Width = "300" 
Loaded = "Windowl_Loaded" 
> 

<Grid Name="gridl"> 
</Grid> 
</Window> 

Si può creare da codice l'istanza host di 
WindowsFormsHost ed aggiungerla alla Grid 
denominata gridi così: 

void Windowl_Loaded(object sender, 

RoutedEventArgs e) 

{ 

WindowsFormsHost host = new 

WindowsFormsHost(); 
System. Windows. Forms. TreeView treeViewl 

new System. Windows. Forms. TreeView(); 
PopulateTree(treeViewl); 
host.Child 
= (System. Windows. Forms. Control) treeViewl; 
this.gridl.Children.Add(host); 
T~ 

Il metodo PopulateTree, che si tralascia riman- 
dando al paragrafo Creare servizi e client WCF, si 
occupa di ricavare dal proxy del servizio 
PizzaService il listino delle pizze e popolare l'al- 
bero. 



WINDOWS FORMS IN WPF 

Che fine faranno i controlli Windows Forms che 
ogni sviluppatore è abituato a utilizzare, o quelli 
custom che sono costati giorni o mesi? 
Tranquilli, possono essere tranquillamente uti- 
lizzati in WPF. 

Esiste la classe WindowsFormsHost il cui scopo è 
proprio quello di contenere un qualunque con- 
trollo Windows Forms, standard o custom. 
Per utilizzare tale classe è necessario aggiungere 
al progetto WPF i due riferimenti agli assembly 
System.Windows.Forms.Integration e System. 
Windows.Forms. Come esempio riutilizziamo 
quanto visto nel paragrafo su WCF, in particolare 



CONCLUSIONI 

Nell'articolo si è data un'introduzione di .NET 
Framework 3.0, e dei suoi componenti fonda- 
mentali, dedicati alla comunicazione, alla 
creazione di applicazioni basate su workflow, 
alla definizione di moderne interfacce grafi- 
che, ed alla gestione delle identità digitale. Si è 
cercato di creare qualche esempio introduttivo 
per mostrare il nuovo modo di sviluppare che 
attende alla porta gli sviluppatori Windows, ma 
certamente sarà necessario tornare sui singoli 
argomenti, cosa che faremo sicuramente nei 
prossimi numeri 

Antonio Pelleriti 
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GLI STRUMENTI DI 
SVILUPPO DEL FUTURO 

EXPRESSION: È QUESTO IL NOME CHE MICROSOFT HA VOLUTO DARE ALLA SUA NUOVA SUITE 

PER LA CREAZIONE DI INTERFACCE GRAFICHE E CONTENUTI MULTIMEDIALI. 

LA NOVITÀ È CHE QUESTA VOLTA TUTTO È PENSATO PER AIUTARE GLI SVILUPPATORI... 



.net 



UCDU 



WEB 



ì 



Kp 



in 







conoscenze minime 
di.NET 



> NET Framework SDK 
' 3.0, Interactive 
Designer 




Microsoft Expression è una nuova suite 
di prodotti pensata per sviluppatori e 
designer operanti sia sul web sia sulle 
applicazioni desktop. 

Odotti: Interactive Designer, è il nuovo strumen- 
to per sviluppatori dedicato alla progettazione 
di interfacce grafiche secondo una concezione 
innovativa ed in grado di renderle molto più 
accattivanti delle GUI attuali. 
Web Designer è praticamente il successore di 
FrontPage e quindi è dedicato allo sviluppo web 
affiancandosi a Visual Studio 2005, data la natu- 
ra ormai dinamica della maggioranza dei siti 
web. 

Graphic Designer: è infine la nuova applicazio- 
ne di grafica e manipolazione delle immagini, 
destinato a competere con mostri sacri quali 
possono essere Photoshop e Illustrator. 
Per ognuno dei prodotti della suite Expression 
sono disponibili al momento delle CTP 
(Community Technology Previ ew), liberamente 
scaricabili dal sito ufficiale di Microsoft 
Expression (vedi box laterale), e che permettono 
di conoscere e familiarizzare con i prodotti, 
prima dell'uscita della versione definitiva. 
Naturalmente è sconsigliato utilizzare le CTP in 



STALLAZIONE DEGLI EXPRESSION TOOLS 



REQUISITI 



Per utilizzare i tools 
Expression, è necessario 
installare o possedere una 
versione del .NET Framework. 
Per Expression Web Designer è 
sufficiente la versione 2.0, 
mentre per Interactive 
Designer e Graphic Designer è 
necessario aggiornare alla 
versione 3.0 di .NET. I sistemi 
operativi supportati sono 
Windows XP con almeno SP2, o 
successivi. Windows Vista non 
ha bisogno di altre 



installazioni, in quanto .NET 
Framework 3.0 è parte 
integrante del sistema 
operativo. 

Una volta scaricati i file di 
setup dei tre tool o di quelli 
che desiderate utilizzare, 
l'installazione non richiede 
nulla di particolare rispetto ad 
un qualunque altro applicativo 
Windows, lanciate i file 
setup.exe ed attendete il 
termine della procedura 
guidata. 



fase di produzione e con dati sensibili, in quan- 
to potrebbero esserci bachi o malfunzionamen- 
ti non ancora scovati. Scopo di questo articolo è 
fornire una panoramica di insieme della suite 
Microsoft Expression. Focalizzeremo poi la 
nostra attenzione su Interactive Designer che è 
uno strumento che potrebbe aiutare moltissimo 
il programmatore nello sviluppo di interfacce 
grafiche 



LE MUOVE TECNOLOGIE 

Alla base dei tool della serie Expression sta la tec- 
nologia WPF (Windows Presentation 
Foundation), che a sua volta è anche un compo- 
nente fondamentale del nuovo .NET Framework 
3.0 e dunque di Windows Vista. 
WPF, conosciuto in precedenza anche come 
Avalon, è il sistema unificato di presentazione 
che Microsoft utilizzerà per le future versioni di 
Windows. Il suo motore si avvantaggia del- 
l'hardware di ultima generazione e fornisce clas- 
si che gli sviluppatori potranno utilizzare per 
creare applicazioni ricche di animazioni e conte- 
nuti multimediali. 

Tutto ciò è basato sull'altrettanto nuova tecnolo- 
gia chiamata XAML (Extensible Application 
Markup Language), un linguaggio di markup che 
permette di definire e specificare il comporta- 
mento e l'aspetto dell'interfaccia utente per 
mezzo di XML. 

Tutti gli strumenti Expression contengono la fun- 
zionalità di esportazione in formato XAML, e 
permettono quindi di sfruttare al massimo le 
caratteristiche della tecnologia WPF, in maniera 
semplice e immediata e di facile integrazione 
con il resto del sistema.. Per esempio sarà possi- 
bile disegnare pulsanti dalla grafica accattivante, 
esportarli in XAML, ed utilizzarli in una qualun- 
que applicazione Windows, senza essere più 
legati ai classici e grigi pulsanti a cui siamo abi- 
tuati da decenni. Vediamoli nel dettaglio. 
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INTERACTIVE 
DESIGNER 

Expression Interactive Designer è lo strumen- 
to per la creazione di interfacce e contenuti 
grafici per la piattaforma Windows. 
Interactive Designer contiene una completa 
serie di strumenti di disegno vettoriale e bit- 
map, per la creazione di animazioni, di grafica 
3D ed integrazione con altri contenuti multi- 
mediali. La cosa probabilmente più interes- 
sante per programmatori e sviluppatori, abi- 
tuati a masticare codice è la possibilità di pas- 
sare dalla vista per il design a quella che 
mostra il corrispondente codice XAML, in 
pratica in maniera totalmente analoga a 
quanto si è abituati a fare in Visual Studio, sia 
in ambito Windows, che in ambito Web con le 
pagine aspx suddivise in parte grafica e parte 
HTML. 

Come si può notare dalla figura al lato, la stes- 
sa interfaccia grafica di Interactive Designer è 
basata su WPF, per consentire un livello supe- 
riore di controllo del layout e dei singoli ele- 
menti di una GUI. 

Si vedrà ora come utilizzare Interactive 
Designer per realizzare la nostra prima appli- 
cazione che sfrutti i prodotti Expression, 
magari esplorando qualche caratteristica più 
avanzata. Come quasi sempre accade, il 
nostro progetto implementerà l'immancabile 
applicazione per la ricerda degli arretrati dei 
numeri di ioProgrammo. 
Il primo passo è aprire Interactive Designer e 
creare un nuovo progetto. Basta selezionare il 
menù File e poi New Project. A questo punto 
si potrà scegliere la tipologia di progetto fra 
due possibili, Standard Application o Control 
Library. Si selezioni la prima e si dia un nome 
al progetto, per esempio ioProgrammo, come 
si può vedere in figura 3: 
Sempre nella stessa finestra di dialogo è pos- 
sibile scegliere il linguaggio di sviluppo, fra C# 




Projezt Marne: | loProgramm J 



Language: C£ 



OK Canee 



e Visual Basic, in questo caso lasciamo la scel- 
ta su C#. 

Dopo aver fatto clic su OK si aprirà una nuova 
scena, vuota, chiamata di default 
Scene l.xaml, e che costituirà la nostra super- 
ficie di lavoro. È possibile rinominare la scena 
e dunque i relativi file a proprio piacimento, 
basta esplorare sulla destra la finestra 
Projects, selezionare il file Scene l.xaml e fare 
clic con il tasto destro per poter scegliere il 
comando Renarne. 

Chiamiamolo ioProgrammo.xaml e notiamo 
come anche il file .cs sottostante, visualizzabi- 
le espandendo l'albero, verrà automatica- 
mente rinominato in ioProgrammo.xaml.es. 
Dalla stessa interfaccia di Interactive 
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Fig. 4: L'interfaccia grafica di Interactive Designer 




RAPHIC DESIGNER 



Expression Graphic Designer è 
lo strumento per la creazione 
di grafica vettoriale o bitmap. 
La figura seguente (figura 1) 
mostra l'interfaccia del tool. 
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Fig. 1: Un'immagine creata con 
Graphic Designer. 



con uno dei disegni facenti 
parte del tutorial e che rende 
bene l'idea delle possibilità di 
Graphic Designer. 
Essendo pienamente integrato 
nella suite e predisposto a 
supportare gli strumenti di 
sviluppo futuri ed il .NET 
Framework 3.0 è ovviamente 
dotato della possibilità di 
esportare un qualunque 
disegno in formato XAML. 
Come già detto questo formato 
è facilmente utilizzabile per la 
definizione di interfacce 
grafiche e contenuti avanzati 
di Windows Presentation 
Foundation. 



Fig. 3: La seiezione del tipo di progetto 
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Designer è possibile visualizzare e modificare 
il codice C#, sfruttando anche le funzionalità 
di evidenziazione della sintassi e di 
Intellisense tipiche di Visual Studio o degli 
IDE moderni. 

Per inserire un qualsiasi controllo, basta sele- 
zionarlo dalla finestra Library e poi disegnar- 
lo sulla scena. Se la palette Library non fosse 
visibile basta selezionarla dal menu View. 
Supponendo di voler creare un'applicazione 
per consultare i numeri arretrati di 
ioProgrammo, utilizzeremo una ListBox che 
conterrà l'elenco, una casella di testo che poi 
conterrà il sommario del numero selezionato 
ed un oggetto Image che visualizzerà la 
copertina del numero selezionato. 
L'interfaccia così pensata apparirà all'interno 
di Interactive Designer come nella figura 
seguente: 

In questo caso si è utilizzato come contenito- 
re principale un oggetto Grid, all'interno del 
quale si sono inseriti i controlli ListBox, 
TextBox e Image suddetti. L'oggetto grid ci 
servirà per avere un componente comune da 
utilizzare per il DataBinding, come si vedrà 
nel seguente paragrafo. 



<Products> 



nr™™''!!''^''!! 11 «"—"' 



^ 






loProgrammo 














Fig. 5: II progetto dell'interfaccia dell'applicazione 



SORGENTI DI DATI 

I dati delle riviste da visualizzare saranno 
contenuti e letti da un file XML che avremo 
precedentemente preparato Interactive 
Designer permette di aggiungere una sorgen- 
te dati XML semplicemente con pochi clic del 
mouse. Innanzitutto creiamo un file con una 
struttura adatta al nostro esempio, il seguen- 
te è un estratto di tale XML: 

<Catalog> 



<Rivista> 



<Name> loProgrammo 
n° 103</Name> 



< Image >Images\4- 
103g.jpg</Image> 



<Description> 



Sommario 
del numero 



</Description> 



<Price>€5.90</Price> 



</Rivista> 



</Products> 



</Catalog> 

A questo punto il file XML può essere utilizza- 
to da Interactive Designer per ricavare i dati 
da mostrare nell'applicazione. Bisogna 
innanzitutto aggiungere un nuovo XML Data 
Source. Basta visualizzare la finestra Data, 
quindi fare clic su Add XML Data Source e poi 
dalla finestra di selezione del file (vedi figura 
6) sfogliare per trovare il file XML appena 
creato. 



P3 Add XML Data Source 



Connection Nane: XMLDa:aSource 



II 



Enter the URL fortfie XML data: C:\Docunen:5 and Seti rg^.usen, Dee jt Brcw&s... 



|fv) More Dsia Se re; Options... 



^e5tT~s Zc'c iC-rce Corredi or 



| QK | | Cancd | 



Fig. 6: Aggiungere una nuova sorgente dati 

Ora possiamo procedere al binding dei dati. 
Innanzitutto selezioniamo la proprietà 
DataContext dell'oggetto Grid. Il DataContext 
consente agli elementi figli di un oggetto, 



Select a source that will prò vide data to 'Grid. DataContext' 

Select s Bhding Source: 






Element Property Exp kit ::a:sCcite> 






Relds 

„ Catalog 
,■ Products 
,. fSvista"Ì'nI 



:v;: h'fichi"; Typ~: ; : ' 



Add XHL Data Source.., 



Nama : (String) 
Image : (String) 
Desmptìon : (String) 
Price : [String) 



OUseacus:on >'?èt r a:-; r =ssi;' 
/Catalog/Prcduccs/R v sta 



| v More Binding Options... 



Cancel 



Fig. 7: Connessione alla sorgente dati 
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come ListBox e Image, di ereditare informa- 
zioni sulle sorgenti di dati dai propri elemen- 
ti padri, in questo caso Grid. 
Cliccando sulla proprietà DataContext appa- 
rirà il menù contestuale, e da questo si potrà 
selezionare la voce Databind. 
Dalla finestra di dialogo aperta a questo 
punto aperta (mostrata in figura 7), potremo 
selezionare l'elemento Rivista dall'albero 
della nostra sorgente dati e poi fare clic su 
Finish. Ora sarà possibile utilizzare le infor- 
mazioni ricavata dal file XML e visualizzarle 
nei diversi componenti dell'interfaccia grafi- 
ca, il tutto all'interno di Interactive Designer. 
Dopo aver aggiunto una ListBox alla Grid, e 
magari dopo averne modificato l'aspetto a 
proprio piacimento con gli strumenti grafici 
a disposizione, si faccia clic con il tasto destro 
su di essa, selezionando la voce Bind to Data 
dal menù contestuale. 

Nella finestra di dialogo per il Data Binding 
questa volta si selezioni prima Explicit 
DataContext come Binding Source, in quanto 
vogliamo utilizzare la sorgente precedente- 
mente impostata per la Grid. 
In questo caso vogliamo che la ListBox mostri 
solo il numero della rivista, cioè solo l'ele- 
mento Name letto dal file XML. Quello che si 
fa in questo caso è creare un template ad hoc 
ed applicarlo al controllo ListBox. Il tutto può 
essere fatto da interfaccia grafica oppure da 
codice XAML, per esempio: 

<DataTemplate x:Key="RivistaTemplatel"> 
<StackPanel x:Name="StackPaner> 

<TextBlockx:Name="TextBlock" 
Text="{Binding Mode=OneWay, XPath = Name}"/> 

</StackPanel> 
</DataTemplate> 
Ed applicandolo poi impostando la proprietà 

ItemTemplate della ListBox: 
<ListBox x:Name = "ListBox" 

ItemTemplate="{DynamicResource 
RivistaTemplatel}"> 

Un'altra possibilità, forse più immediata, è 
quella di creare la ListBox ed il suo template 
visivamente a partire dalla sorgente dati. 
Dalla finestra Data selezioniamo il nodo 
Rivista [n] e trascinimolo sulla Grid, rilascian- 
do il mouse apparirà un menù contestuale 
che permette di scegliere la tipologia di con- 
trollo da utilizzare per rappresentare i dati. 
Scegliamo una ListBox in questo caso ed il 
campo ItemsSource come destinazione. 
Subito dopo potremo creare il template da 
utilizzare. Si selezioni solo il campo Name in 
quanto solo questo sarà visualizzato nella 



lista. 

Allo stesso modo si può creare un'immagine 
bindata all'elemento Image della Data 
Source. In questo caso però bisogna prima 
aggiungere un controllo Image alla Grid, poi 
selezionare la sua proprietà Source e fare clic 
su Databind. Ancora una volta come Binding 
Source si scelga Explicit DataContext e sta- 
volta come campo si scelga Image. 
Tralasciamo la procedura per aggiungere un 
campo di testo e collegarlo all'elemento 
Description che conterrà il sommario della 
rivista, in quanto perfettamente analogo, 





Fig. 8: Creare un template per la ListBox 



WEB DESIGNER 



Expression Web Designer è lo 
strumento per la creazione è 
manutenzione di siti web statici 
o dinamici in asp.net, e basati 
su standard. La figura 2 mostra 
l'interfaccia del tool: 



ssssL— * 




Fig. 2: Web Designer all'opera. 

Web Designer permette in 
maniera semplice di verificare 
la conformità agli standard, 
consentendo quindi di 
apportare le necessarie 
correzioni in fase di sviluppo e 



non dopo aver messo on line 
sito e dopo averlo validato. È 
inoltre possibile generare stili 
ed applicarli agli elementi 
tramite la sua interfaccia in 
maniera notevolmente 
migliorata rispetto alle scarne 
possibilità dell'editor HTML di 
Visual Studio 2005. 
Allo stesso modo è possibile 
creare layout professionali e 
WISYWIG basati su CSS. Così 
come in Visual Studio è poi 
possibile creare siti che 
necessitano di accesso ai dati, 
per esempio utilizzando i 
controlli DataSource di ASP.NET, 
per connettersi a database 
Access, SQL Server, Oracle. 
Citiamo infine, essendo un 
prodotto Microsoft, il pieno 
supporto per le caratteristiche 
avanzate di ASP.NET 2.0, vale a 
dire Data Binding, nuovi 
controlli, pagine Master, stili, e 
debugging mediante server di 
sviluppo locale. 
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basta effettuare il Data Binding sulla pro- 
prietà Text. 



^> 



DELL'APPLICAZIONE 

Chi è più curioso potrà visualizzare a questo 
punto il codice XAML prodotto da Interactive 
Designer, semplicemente facendo clic sulla 
linguetta XAML dell'editor. 
Soddisfatta tale curiosità si potrà infine ese- 
guire la nostra nuova applicazione. È possibi- 
le compilare il progetto dal menù Project per 
mezzo del comando Build Project e poi testar- 
lo mediante il comando Test Project oppure 
semplicemente premendo il tasto F5. 
Compilato ed eseguito il progetto, il suo 
aspetto dovrebbe essere simile a quello della 
figura seguente: 



MODIFICARE IL CODICE 

Noterete neir applicazione di esempio, la pre- 
senza di un pulsante Button, aggiunto 
anch'esso tramite l'interfaccia di Interactive 
Designer ed il cui codice XAML è il seguente: 



<Button HorizontalAlignment= 


"Right" 




VerticalAlignment= 


Top" 


Margin = 


'0,-69,0,0" 


Width = 


"126" Height: 


= "36' 


x:Name: 
Content= 


= "Buttonl" 
= "About"/> 



loProgrammo 



Abou: 




Per gestire il click su di esso apriamo a questo 
punto il progetto con Visual C# Express 
Edition. I più esperti di C# saranno in grado di 
gestire l'evento Click in pochi secondi, sem- 
plicemente scrivendo qualche riga di codice 
all'interno della classe Scenel: 



pubi 


e partial class Scenel 


{ 




pubi 


e ScenelQ 


{ 


this.InitializeCom ponent(); 


Buttonl. Click += new 
RoutedEventHandler(Buttonl_Click); 


} 




void 

{ 


Buttonl. 


_Click(object sender, 

RoutedEventArgse) 



MessageBox.Show("Aplicazione di 
esempio creata con Interactive Designer" 
"About", MessageBoxButton.OK, 
MessageBoxImage. Information) 



> 



Fig. 9: L'applicazione in esecuzione 



Ciò mostra come gli strumenti Expression, in 
questo caso Interactive Designer, siano piena- 
mente integrati e compatibili con Visual 
Studio 2005. 



CONCLUSIONI 

Gli strumenti Expression di Microsoft rappre- 
sentano un'ottima opportunità per scatenare 
la propria fantasia e creare applicazioni ricche 
di contenuti grafici in maniera rapida e velo- 
ce. Inoltre essi si integrano perfettamente fra 
di loro e con Visual Studio 2005, permettendo 
di lavorare ai diversi aspetti di un'applicazio- 
ne, da quello puramente grafico al codice 
.NET sottostante. Nell'articolo si è dato più 
risalto ad Interactive Designer, gli sviluppato- 
ri Web sicuramente saranno più attratti da 
Web Designer, mentre i grafici da Graphic 
Designer. Ciò che è importante capire è che 
XAML si configura come una sorta di formato 
dati universale utilizzato per creare template 
a qualunque livello. Si può partire da un'inter- 
faccia in Photoshop importata poi in uno 
degli strumenti Expressioni, oppure diretta- 
mente in Visual Studio, ciò che conta è che lo 
sviluppatore non è più l'elemento di disomo- 
geneità all'interno di un team di sviluppo, 
piuttosto ne diventa il collante 

Antonio Pelleriti 
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UNA MAILING LIST 
GESTITA SUL WEB 

ABBIAMO REALIZZATO UN SERVIZIO CHE GESTISCE UNA LISTA DI DISTRIBUZIONE DELLA 
POSTA SENZA AVERE INSTALLATO NESSUN SOFTWARE LATO SERVER MA SOLO DELLE PAGINE 
WEB. VEDIAMO ORA COME CREARE IL CLIENT PER LA CONSULTAZIONE 




I 



n un precedente articolo abbiamo parlato di 
come implementare una mailing list attraverso 
, dei Web Services. Avevamo illustrato la costru- 
zione dell'applicazione server, resta quindi da vede- 
re come implementare il Client. Poiché stiamo par- 
lando di un un servizio web le possibilità che abbia- 
mo per realizzare il client sono due: Applicazione 
desktop, Applicazione Web. Per comodità di distri- 
buzione scegliamo la seconda, l'applicazione Web, 
ma anche qui ci troviamo di fronte alla scelta di due 
soluzioni: Applicazione ASP.NET tradizionale, 
Applicazione AJAX. L'applicazione AJAX consente 
una maggiore interazione tra client e server, evita il 
continuo ricaricamento della pagina ed il lavoro 
aggiuntivo di elaborazione HTML richiesto al ser- 
ver; per contro questa tecnologia non è adatta a 
tutti i browser in circolazione (o a quelli che ad 
esempio hanno disabilitato alcune funzioni come 
Javascript). Qui, tuttavia, parliamo di amministrare 
la Mailing List, operazione che deve essere fatta da 
una ristretta cerchia di persone a cui possiamo 
richiedere requisiti software precisi, quindi la nostra 
scelta si indirizzerà sull'applicazione AJAX. È chiaro 
che se volessimo invece approntare alcune pagine 
pubbliche, ad esempio per l'iscrizione e la cancella- 
zione, dovremmo, per queste parti, usare ASPNET. 



mente le liste di messaggi e invia le e-mail. 

La struttura dei dati, serializzata in un file xml sul 

server, è suddivisa in: 

• Categorie 

• Utenti 

• Messaggi 

Ogni oggetto Utente contiene una lista di categorie 
associate. Anche ogni oggetto Messaggio contiene il 
riferimento ad una lista di categorie, in modo che, 
in fase di invio, si potrà recuperare la lista di utenti a 
cui effettuare l'inoltro tra tutti gli utenti che hanno 
le categorie del messaggio nella propria lista di cate- 
gorie. Il Messaggio ha anche un Registro associato 
dove il programma può scrivere l'esito di ogni ten- 
tativo di invio, in modo da evitare di inviare più 
volte lo stesso messaggio ad un utente. La libreria 
contiene anche una classe, Manager, che fa da 
interfaccia alle chiamate dei Web Services e consen- 
te di manipolare gli oggetti e controllare la serializ- 
zazione- deserializzazione dei dati. Per i Web 
Services è stato progettato, utilizzando i generics, 
una classe OperationResult che ingloba l'oggetto 
risposta in una struttura omogenea che contiene 
anche informazioni sull'esito, eccezioni ecc.. 



n 




REQUISITI 
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LO SCHEMA 
DEL SERVIZIO 

Ricordiamo, in sintesi, le caratteristiche salienti del 
servizio di mailing list illustrato nella prima parte. 
Il servizio non è un servizio di Windows, siamo par- 
titi dal presupposto che dovesse essere possibile far 
funzionare la Mailing List presso un Internet 
Provider che offra spazio in Hosting (dove ovvia- 
mente non avremmo possibilità di installare nien- 
te), quindi, sfruttando gestori di eventi a livello di 
applicazione posti nel file global.asax (che, lo ricor- 
diamo, non funziona solo per ASPNET ma anche 
per i Web Services) facciamo partire un Thread 
secondario in background che controlla ciclica- 



IMPLEMENTAZIONE 
DEL CLIENT AJAX 

Si tratta adesso di costruire l'interfaccia AJAX per il 
Client ai nostri Web Services. AJAX, lo ricordiamo 
per l'ennesima volta, non è un linguaggio di pro- 
grammazione ma significa semplicemente mani- 
polare l'XML con Javascript per interagire con la 
pagina Web. Quello che ci serve quindi è: 

1) Un server che ci dia risposte in XML 

2) Un set di funzioni Javascript per inviare richieste 
e ricevere risposte dal server 

3) Alcune pagine web HTML dove trovano vita gli 
scripts. 
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IL SERVER 

Costruendo i Web Services il primo requisito l'ab- 
biamo già soddisfatto, infatti la chiamata a un Web 
Service dà sempre luogo a una risposta XML (sem- 
pre che l'oggetto della risposta sia serializzabile). 
Gli unici accorgimenti per utilizzare l'output XML di 
un Web Service .NET con Javascript sono: 

1) abilitare il protocollo POST per l'interrogazione al 
Web Service inserendo nel file web.conflg del sito 
dove risiede il servizio con: 

<configuration> 
<system.web> 

<webServices> 

<protocols> 

<add name="HttpPost"/> 

</protocols> 
</webServices> 
</system.web> 
</configuration> 

questo ci consentirà di indirizzare chiamate 
HTTPRequest da Javascript con il metodo POST 
(non che con SOAP non sia possibile, ma richie- 
derebbe un mucchio di lavoro in più). 

2) dichiarare, nella classe del Web Service, un 
Namespace vuoto, così: 

<WebService(Namespace:="")> _ 
Public Class MyWebService 



End Class 



Javascript! Ciò significa che se una libreria, magari 
ottimamente costruita e ricca di funzioni, "pesa" 
200kb gli utenti con una linea poco veloce percepi- 
ranno una generale lentezza del sito. 
Inoltre c'è da dire che, per quanto complete e ben 
fatte, molte librerie AJAX richiedono uno studio 
ulteriore delle API, cioè delle funzioni da chiamare 
per utilizzarle, per cui, da una cosa relativamente 
semplice come il colloquio con HTTPRequest si 
finisce a dover studiare i Massimi Sistemi! 
Dalle considerazioni di cui sopra, io sono arrivato 
alla considerazione di costruirmi una mia persona- 
le libreria (il file xml.js che trovate nei sorgenti) che: 

1) "pesa" 11Kb 

2) riproduce anche in Firefox i metodi e le funzioni 
della libreria XML di Microsoft, semplice da usare 
e ben documentata. 

Oltre alla libreria di funzioni AJAX nei sorgenti si tro- 
vano anche altre librerie Javascript che servono per 
non complicarsi troppo la vita nella stesura del 
codice. Ad esempio, la funzione usata per riferirsi a 
un elemento HTML a partire dal suo ID sarebbe: 

document.getElementById("elementl") 

poiché questa è una funzione usata innumerevoli 
volte nel codice ho pensato a realizzare una libreria 
di supporto che contiene un Wrapper di questa fun- 
zione come: 

function $(id) { return document.getElementByld(id)} 

In tal modo sarà sempre possibile utilizzare 




questo non sarà proprio conforme a tutti gli stan- 
dards per i Web Services, ma ci consente di mani- 
polare meglio il risultato con XPATH, senza que- 
sto accorgimento infatti viene inserito, nell'XML 
di output, un default namespace del tipo: 

<?xml version="1.0" encoding="utf-8"?> 
<root xmlns="http://mionamespace.org"> 



$("elementl") 

invece della forma canonica, risparmiando sia in Kb 
dei file Javascript che in battute di tastiera . . . 
Questa ed altre analoghe scorciatoie o funzioni di 
supporto si trovano in un'altra libreria che utilizzo 



AJAX: FU VERA GLORIA? 



alcuni browser (come Firefox) hanno difficoltà 
nell'implementazione di query XPATH con 
un default namespace quindi meglio evitare. . . 



LE FUNZIONI JAVASCRIPT 

Di librerie AJAX da utilizzare con Javascript ce n'è un 
po' per tutti i gusti. Una cosa che bisogna però tene- 
re in considerazione è che il client (il browser dell'u- 
tente) quando si collega ad una pagina web non si 
scarica solo l'HTML e le immagini, ma anche i file 



AJAX, a mio modesto avviso, è 
un po' I' "invenzione 
dell'acqua calda" visto che, in 
realtà, non è altro che la 

I manipolazione dei dati XML 
esterni con Javascript. 
Questo si poteva fare fin dalla 

■ versione 4 di Internet Explorer, 
solo che - nei siti web pubblici 
- abitualmente non si faceva 
perchè Internet Explorer era 
l'unico browser che forniva - 
seppur in forma proprietaria - 



strumenti XML da usare con 
Javascript. 

Adesso si fa perchè anche altri 
browser (come Firefox) 
supportano XML e quindi le 
applicazioni sono 
sufficientemente cross- 
browser. Poi qualcuno ha avuto 
la bella idea di inventarsi il 
simpatico nome AJAX 
(acronimo per "Asynchronous 
JavaScript And XML") ed è nata 
l'ennesima moda... 



J 
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^ 




spesso per il DHTML chiamata core.js (anch'essa 
ovviamente presente nei sorgenti). 
Naturalmente, per motivi di spazio, non possiamo 
metterci ad analizzare nel dettaglio tutte le funzio- 
ni presenti nelle librerie che includeremo nel 
nostro file HTML, ne parlo solo perché se analizze- 
rete il sorgente, e negli esempi successivi, può 
esserci la chiamata a funzioni presenti in tali file. 



L'IMPLEMENTAZIONE 
CONCRETA 

Armati delle librerie "generiche", utili a svolgere le 
funzioni di interscambio e formattazioni dei dati, 
dobbiamo quindi implementare la logica specifica 
della nostra applicazione. Passiamo ad analizzare 
subito un esempio per comprendere meglio la logi- 
ca di funzionamento del colloquio client/ server. 
Per prima cosa dobbiamo precisare che tutto, Web 
Services, pagine web, file Javascript devono essere 
interni allo stesso sito web (questo perché, per 
motivi di sicurezza, non è possibile effettuare chia- 
mate HTTPRequest in altri siti), quindi andiamo ad 
operare nella stessa directory dove, la volta scorsa, 
abbiamo messo i file dei Web Services e configura- 
ta come directory virtuale in US. Qui creiamo una 
cartella per gli scripts ed una per i CSS e, nella direc- 
tory base inseriamo due nuovi file HTML: 



SORGENTI NEL CD 



Nel CD allegato alla rivista si 
trova il codice sorgente 
dell'applicazione completo, sia 
per la parte dei Web Services che 
per il client AJAX illustrato 
nell'articolo. 
Per quanto funzionante 
l'applicazione è da considerarsi 
più come un prototipo che come 



un programma; prima di poterla 
usare in produzione deve essere 
ancora testata a fondo e, nel 
client, devono essere 
implementate funzionalità 
(caricamento asincrono anziché 
sincrono e paginazione e filtri 
sulle tabelle tra tutte) 
indispensabili nel mondo reale. 



Return DoOperation(Of User, UserResult)("", 
Mailer, "LoginUser", "users.login", mail, password) 
End Function 

ricordiamo che UserResult non è altro che una 
delle diverse derivazioni di OperationResult ovvero 
il wrapper dell'oggetto effettivo restituito in forma 
serializzata e corredato da informazioni su even- 
tuali errori. 

In questo caso la funzione DoOperation richiama 
attraverso la reflection il metodo LoginUser dell'og- 
getto Mailer . 

Questi sono tuttavia dettagli implementativi, 
andiamo subito a vedere il funzionamento del 
metodo Login aprendo il browser all'indirizzo 
http:lllocalhostlMailinglusers.asmx (presupponen- 
do naturalmente di avere configurato in US la direc- 
tory virtuale chiamata Mailing in corrispondenza 
della path della nostra applicazione). 
Dovrebbe quindi apparire la maschera di test di cui 
in figurai. 
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até* XMln*li*4*~hLLpìJ /*■ 
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Fig. 1: Test del Web Service 

immettiamo mail e password e vediamo la risposta 
XML, che sarà: 



• login.html - che presenta la maschera di login 
per l'utente non autenticato 

• admin.html - che contiene il resto dell'applica- 
zione 

Prima di vedere come abbiamo risolto il problema 
dell'autenticazione dal lato client, vediamo come, 
attraverso Javascript, possiamo richiamare dati dal 
Web Service. 

Abbiamo implementato la funzione di login nel 
Web Service users.asmx in questo modo: 



<?xml version= 


'1.0" encoding ="utf-8" ?> 


< UserResult 




xmlns:xsi= 


="http://www.w3.org/2001/XMLSchema- 




instance" 


xmlns:xsd= 


= "http://www.w3.org/2001/XMLSchema" 




success="true" /> 



ovvero con il solo elemento UserResult, nel caso in 
cui il login sia fallito (l'attributo success sta infatti 
ad indicare che l'operazione non ha causato ecce- 
zioni). 
Mentre in caso di login positivo la risposta sarà: 



<WebMethod()> . 



Public Function Login(ByVal mail As String, ByVal 

password As String) As UserResult 



<?xml version="1.0" encoding ="utf-8" ?> 
< UserResult 

xmlns:xsi="http://www. w3.org/2001/XMLSchema- 
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instance" 
xmlns:xsd = "http://www. w3.org/2001/XMLSchema" 

success="true"> 



<data> 



<user id="l" name="admin" 

mail="francesco@smelzo.it" power="100" 
password="fs" categories="2;l" /> 



</data> 



</UserResult> 

e quindi con un corpo costituito dall'elemento data 

al cui interno è serializzato l'oggetto della risposta 

(in questo caso user). 

Quindi non resta che vedere come chiamare lo 

stesso metodo da Javascript. 

Il codice, che fa uso di varie funzioni presenti nelle 

librerie di supporto, è il seguente: 

var users=new Object(); 

users.login = function (mail,password){ 

return loadSync("users.asmx /Login", 
"mail=" + 

mail.toStringQ.toURIQ + 

"&password=" + 
password. toString().toURI()) 
T~ 

È appena il caso di dire che IoadSync è una funzio- 
ne definita nelle librerie di supporto che si occupa 
della chiamata HTTPRequest in forma sincrona. 

I parametri mail e password vengono passati al 
Web Service attraverso la codifica URI standard 
(secondo parametro della funzione IoadSync). 

II risultato della funzione sarà un XMLDocument 
navigabile con XPATH. 

Questo codice viene utilizzato per implementare il 
sistema di autenticazione. 



IL SISTEMA 

DI AUTENTICAZIONE 

Viene quindi utilizzata una routine di autentica- 
zione che controlla che nei Cookies sia presente il 
valore UID : 



function checkAuth(){ 


if(Cookies.get("UID",0)= 


=0){ 


top. location = "login. html?ref=" 
+ encodeURIComponent(top. location); 


return false 


} 


return true; 


} 



Se non trova il Cookie l'utente non è autenticato e 
quindi lo ridireziona verso la pagina di login 
aggiungendo all'uri il parametro ref che rappresen- 




RCHE NON JSOM? 



JSOIM (se ne è parlato in altri 
articoli di IoProgrammo) è 
un'altra tecnica di 
programmazione asincrona con 
Javascript alternativa ad AJAX, 
mentre in AJAX i dati vengono 
forniti dal server attraverso 
XML in JSON (JavaScript Object 
Notation) vengono forniti 
direttamente come oggetti 
Javascript serializzati. 
Dalla sua JSON ha la maggiore 
leggerezza del flusso e, 
ovviamente, una maggiore 
integrazione con Javascript. 
Di contro però la nostra 



applicazione Server dovrebbe 
"parlare" in JSON e non XML e 
quindi ci taglieremo fuori la 
possibilità di sviluppare client 
di altro tipo (dalla web 
application tradizionale fino 
alle applicazioni desktop, che 
invece possono interagire 
comodamente con i Web 
Services) . 

E poi, diciamolo chiaramente, 
la gestione di XML non è poi 
così difficile, tanto più che, una 
volta imparata, ci può tornare 
utile in centinaia di ambiti 
diversi. 



a 



ta l'indirizzo della pagina che ha originato la richie- 
sta. 

Quindi, nella pagina che vogliamo proteggere (nel 
nostro caso admin.html) andremo a richiamare 
questa funzione sotto l'evento onload: 

window.onload = function () { 

if ( checkAuthQ ) { 

// codice di inizializzazione della pagina 
} 



} 



Se checkAuth fallisce la pagina di ridireziona 
appunto verso login.html. Quest'ultima presenta 
una maschera di login espressa in HTML in questo 
modo: 

<form method="post" onsubmit="return 

formSubmit()"> 
<table cellpadding="0" cellspacing="0" 

class="panel"> 
<tr align="left"> 

<td class="captionBar"> 
Login 

</tr> 

<tr align="left"> 

<td> 

<div>E-mail</div> 
<divxinput 
type="text" id="mail" name="mail7></div> 

</td> 

</tr> 

<tr align="left"> 

<td> 

<div>Password</div> 
<div> 
<input type= "password" id="password" 
name="password"/x/div> 

</td> 

</tr> 

<tr align="right"> 
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L'AUTORE 



Francesco Smelzo è 

specializzato nello 

sviluppo in ambiente 

Windows con 

particolare riferimento 

ad applicazioni in 

ambiente .NET sia 

web-oriented che 

desktop. 

Il suo sito web è 

www.smelzo.it. Come 

sempre è a 

disposizione per 

ricevere suggerimenti 

o richieste sull'articolo 

all'indirizzo di posta 

elettronica 

francesco@smelzo.it 



<td> 


<div> 




<input type 


="submit' 


value="0k"/> </div> </td > 


</tr> 






<tr align= 


"leff'xtd id= 


"result"> 


</td> 


</tr> 


</table> 


</form> 



L'autenticazione avviene quindi all'interno della 
funzione formSubmitO che è espressa così: 



function formSubmit(){ 



//chiamata del webservice attraverso users.login 
var result = 
users.login($E.value("mair i ),$E.value("password")); 



//result è un XMLDocument 



//viene individuato il nodo <user> con una query 



XPATH 



var node = result. 

selectSingleNode(7/data/user"); 



if(!isNull(node)) { 



//se il nodo viene trovato viene inserito il valore 

// dell'attributo id nei cookies 



var id = node.getAttribute("id"); 
Cookies. set("UID",id); 



//redireziona verso la pagina originaria 



window.location = ref; 



} else { 



//se il nodo non viene trovato l'elemento non esiste 
//scrive in nell'elemento "result" il messaggio di errore 
$('result').innerHTML="login fallito!" 



} 



return false 





http : //localhost/Mailing/logir, htr;il?n ' 






Ì ^Login 


* E! - § ' \là E^ge ' ® Tooi 5 -r >J 






^J 




E-mail 




1 


Password 


1 


E 






d 


|Done |[^ IO Internet \ 100% - ^ 



Fig. 2: Maschera di login 



L'APPLICAZIONE 
VERA E PROPRIA 

Questo per quanto attiene all'autenticazione, ma 
per tutto il resto? Dobbiamo ancora implementare 
un paio di funzionalità utili per la nostra applicazio- 
ne. In particolare: 



• utenti - aggiunta, modifìca,cancellazione e asse- 
gnazione delle categorie di appartenenza 

2 categorie - aggiunta, modifica e cancellazione 

• messaggi - aggiunta, cancellazione e visualizza- 
zione del registro degli invìi 

Tutte queste attività vengono gestite unicamente 
all'interno del file admin.html, ognuna di esse ha la 
propria logica di funzionamento racchiusa in un file 
Javascript esterno con un nome coerente 
(admin.html.users.js , admin.html.categories.js e 
admin.html.messages.js) . 

Le varie sezioni sono popolate on demand con il 
click sul tab corrispondente. 
La sezione utenti presenta per prima cosa la tabella 
degli utenti che vediamo in figura 3. 
Per mantenere compatta l'interfaccia ed evitare 
ricaricamenti di pagina, la gestione delle categorie 
viene attivata direttamente in una riga "a scompar- 
sa" come vediamo in figura 4 
La modifica dei dati e l'inserimento di nuovi utenti 
viene invece gestita con un finto popup (in realtà un 
DIV a scomparsa) come in figura 5. 
La stessa interfaccia è stata naturalmente utilizzata 
anche nelle altre sezioni. 

L'implementazione grafica vera e propria (costru- 
zione dinamica delle tabelle, CSS ecc..) esula dagli 
scopi di questo articolo e non è importante ai fini 
della comprensione della tecnica, riportiamo qui 
solamente un esempio (semplificato) di rendering 
HTML, attraverso il DOM, di una lista di nodi XML: 

function getCategoriesList(){ 

//recupera XMLDocument dal Web Service 
var doc = categories.Getl_ist(); 
//seleziona con XPATH una lista di nodi 
var nodes = 

doc.selectNodes(7/data/list/category"); 
//crea una tabella con il DOM 



var oTable ■■ 



document.createElement("table"); 



//scorre i nodi XML della lista 



for(var i=0;i<nodes.length;i++){ 



var node = nodes[i]; 



//crea una riga nella tabella 



var oTr = oTable.insertRow(-l); 



//crea la prima cella della riga 



hrtpii'/locàìhost/Mailir.g/adriìin 
"Ù & ^ Mailing Admin 



|^'B T #' lìJ'Eage ^ ®Taols ^ " 



Utenti | 










nuovo utente 


Nome E-mail 




Livello <lìrìtt 






filippo 




50 




Cancella 


adrnin 




100 




Cancella 








FFFFFS"!© Internet 



Fig. 3: Sezione utenti 
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varoTdl = oTr.insertCell(-l); 



//inserisce un valore preso da un 
//attributo del nodo corrente 



oTdl.innerHTML=node.getAttribute("name"); 



//crea una seconda cella nella riga 



var oTd2 = oTr.insertCell(-l); 



oTd2.innerHTML= "Cancella"; 



//infine appende la tabella all'elemento DIV 

esistente 
document.getElementById("catsList").appendChild(oT 

able); 



} 



http://localhost/Mailing/admin.html r 
Ù ■& ^ Mailing Admin | | g% - S) - i§3 - \là B^e ^ ® Tools 



-Inh 

IZE 



Utenti | 











Nome E-mail Livello diritti 


filinnn f.smelz ia.com 50 Cateuoiii 




;:ateqone definite 




:ateqone utente 









E 


Musica 
Cultura 



a dm in 






Fig. 4: Interfaccia assegnazione categorie a utenti 



Tutti i metodi esposti dai Web Services sono stati 
rimappati in corrispondenti funzioni Javascript 
(come abbiamo visto per il login) - tecnicamente 
questo sistema si chiama proxing ed è simile a quel- 
lo che avviene automaticamente quando si istanzia 
un web service in un progetto di Visual Studio. 
Solo come esempio riportiamo un estratto di queste 
funzioni di mapping effettuato sul Web Service 
user.asmx: 

var users=new Object(); 
users.url = "users.asmx" 
users. login = function (mail,password){ 

return loadSync(this.url + "/Login", 
"mail=" + 

mail.toStringQ.toURIQ + 

"&password=" + 
password. toString().tollRI()) 

> 

users. operatorld = function (){ 



http : /.'localhost/Mailir.g/adr.ìin . htr.ìl * 
Ù •& fé Mailing Admin 



Q ' E! T # T Uà Bage * ® Tools - 



Utenti | 



filippo fsrr : 



: ■."•,■-. ; : . 



users. setitem (50) ^1 

| chiudi ||~salva | 





return Cookies.get("UID' 


,0);} 


users 


GetList = function (query, order, action) { 




return IoadSync (this.url 


+ "/GetList", 



"operatorld =" + this.operatorId() + 
"&query=" + query.toString().toURI() + 
"&order=" + order.toString().toURI()); 



} 



users. GetUserCategories = function (userID) { 
return 

loadSync(users.url + "/GetUserCategories" 
"operatorld =" + this.operatorId() + 
"&userID=" + userID.toString().toURI()); 



} 



users.AddUserCategory = function 



(userID,CategoryID) { 



Fig. 5: Editing utenti 



return 
loadSync(users.url + "/AddUserCategory", 
"operatorld =" + this.operatorId() + 
"&userID=" + userID.toString().toURI() + 
"&CategoryID=" + CategoryID.toString().toURI()); 

;.RemoveUserCategory = function 
(userID,CategoryID) { 
return 

loadSync(users.url + "/RemoveUserCategory", 
"operatorld =" + this.operatorId() + 
"&userID=" + 
userID.toString().toURI() + "&CategoryID=" + 
CategoryID.toString().tollRI()); 



uni PICCOLO TRUCCO 

L'operazione di mapping in Javascript dei metodi 
esposti dal Web Service è molto utile per la stesura 
del codice ma è altrettanto noiosa. 
Tuttavia ogni Web Service espone una descrizione 
WSDL della propria struttura raggiungibile con Turi 
http://mioserver/webservice.asmx? WSDL , tale descri- 
zione è in formato XML quindi è possibile trasfor- 
mare questa sorgente utilizzando XSLT in qualsiasi 
output, e quindi anche in codice Javascript che non 
è altro che testo. 



CONCLUSIONI 

Abbiamo visto quindi come creare un client ricco di 
funzionalità con una semplice pagina HTML e un 
bel po' di codice Javascript. Avendo dato questa 
struttura alla parte server del programma (Web 
Services) nulla ci impedisce di sviluppare altri tipi di 
client, da applicazioni Web più "tradizionali" fino a 
client desktop veri e propri mantenendo la stessa 
logica applicativa. 

Francesco Smelzo 
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SVILUPPARE UNA 
CHAT CON AJAX E PHP 

UNO DEGLI UTILIZZI PIÙ DIVERTENTI DI AJAX È SICURAMENTE LA CREAZIONE DI UNA CHAT. 
ECCO COME APPROFITTARE DEL JAVASCRIPT ASINCRONO PER CREARE CHAT PROFESSIONALI 
SUL WEB CON PHP SENZA SCOMODARE PER FORZA JAVA O MACROMEDIA FLASH ! 



La grande innovazione apportata da Ajax 
è, principalmente, legata al fatto che tale 
tecnologia consente di adottare anche 
nell'ambito dello sviluppo web un approccio 
molto simile a quello tipico della programma- 
zione desktop. 

Le prime applicazioni web-oriented, in effetti, 
erano costituite da singoli programmi che 
venivano eseguiti all'occorrenza su richiesta 
dell'utente: il server si limitava a processare la 
richiesta generando l'output da consegnare al 
client, ma al termine di tale procedura basata 
su domanda-risposta la memoria del server 
veniva svuotata e non rimaneva più alcuna 
traccia della transazione. E' proprio per questo 
motivo che si dice che il protocollo HTTP è 
privo di stato, o " sessionless" (per dirlo all'in- 
glese). 

La realizzazione di una vera e propria web- 
application (con tutte le caratteristiche che 
essa comporta) era infatti appannaggio della 
sola nascente piattaforma Java, penalizzata 
tuttavia da molti errori di gioventù (lentezza, 
difficoltà di utilizzo, scarsa stabilità), mentre la 
riproduzione degli stessi meccanismi (o quan- 
tomeno di meccanismi simili) con i linguaggi 
di scripting tradizionali (Asp, Php), era affidata 
più che altro alla fantasia e all'estro del singolo 
programmatore. 

E' vero che presto anche i linguaggi di scripting 
si sono evoluti, integrando funzionalità avan- 
zate per tenere traccia, ad esempio, delle ses- 
sioni lato -server aperte per tutta la durata della 
navigazione da parte dell'utente, tuttavìa la 
necessità di appoggiarsi al protocollo HTTP 
per consentire l'interazione tra client e server, 
di fatto, continuava a rappresentare un ostaco- 
lo insormontabile alla realizzazione di applica- 
zioni veramente efficienti. 
Ed è proprio sull'onda di queste necessità che 
si è fatta avanti la tecnologia Ajax, in grado di 
superare i limiti della programmazione web- 
oriented tradizionale per permettere invece un 



approccio allo sviluppo su Internet molto più 
facile e performante. 

Immaginiamo, ad esempio, di dover realizzare 
una chat, sul modello della Gmail Chat di 
Google o simili: se dovessimo farlo con un lin- 
guaggio di scripting tradizionale, come Php, 
sicuramente incontreremmo qualche ostacolo 
che ci costringerebbe ad adottare degli strata- 
gemmi particolari. 



HTTPXMLREQUEST: 
ISTRUZIONI PER L'USO 



E' evidente che lo sviluppo della chat in moda- 
lità "classica" obbliga il programmatore a usare 
dei "trucchetti" particolari, come inserire un 
tag META nell'intestazione del documento 
html, che effettua un "refresh" automatico 
della pagina ogni tot secondi (un'altra possibi- 
lità sarebbe anche inserire un timer con java- 
script che effettua il reload della pagina, ma 
personalmente tra le due alternative preferisco 
la prima). Il risultato è, tuttavìa, alquanto delu- 
dente se non si dispone di una connessione ad 
Internet sufficientemente veloce, senza conta- 
re che per poter aggiornare solo una parte della 
pagina è necessario lavorare con i frame, con 
tutti i problemi che questi comportano, ovvia- 
mente. 

Per ovviare a tali inconvenienti, ecco quindi la 
necessità di lavorare con Ajax, il quale ci con- 
sente di modificare dinamicamente certe parti 
della pagina senza dover effettuare il reload 
della stessa. Un sito sviluppato con Ajax è 
molto simile ad un'applicazione installata fisi- 
camente su un client che effettua chiamate ad 
un server: la velocità della connessione è molto 
superiore rispetto a quella dei siti classici, 
mentre l'occupazione della banda si riduce 
notevolmente incrementando, di fatto, la resa 
e la produttività dell'applicazione stessa. 
Per capire come funziona un'applicazione 
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PHP 5, MySql, elementi 
di Javascript e Ajax 
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Ajax occorre conoscere il funzionamento del- 
l'oggetto XmlHttpRequest, che in questa sede 
darò in parte per scontato al fine di concentra- 
re l'attenzione solo sugli aspetti più significati- 
vi che contraddistinguono questa tecnologia. 
In realtà esistono ormai diverse librerie che 
affrontano l'argomento anche con approccio 
decisamente avanzato, fornendo talvolta fra- 
mework completi in grado di semplificare al 
massimo lo sviluppo di applicazioni comples- 
se. Tuttavìa, soprattutto per lavori semplici 
come quello che stiamo per sviluppare, affidar- 
si ad una specifica libreria può essere alquanto 
vincolante per il programmatore, mentre lavo- 
rare direttamente con XmlHttpRequest offre 
maggiore libertà di movimento e alleggerisce 
notevolmente le dimensioni dell'applicazione. 
Analizziamo ora le differenze tra un'applica- 
zione standard e una che fa uso, invece, di Ajax: 
osserveremo che nel primo caso, su pressione 
di un pulsante Submit, l'intera pagina si bloc- 
cherà (per tutto il tempo occorrente a termina- 
re la transazione con il server), quindi scompa- 
rirà e verrà completamente sostituita da quella 
effettivamente desiderata. Con Ajax, invece, la 
nostra richiesta remota avverrà in modo com- 
pletamente asincrono, ossia slegato dalla coda 
degli eventi della pagina che continuerà per- 
tanto a rispondere alle nostre sollecitazioni, 
anche nel caso di una transazione con il server 
particolarmente lunga. E' vero che si è instau- 
rata una comunicazione con il server, ma ciò 
avviene in modo del tutto trasparente agli 
occhi dell'utente, che quindi può continuare a 
utilizzare in tutta libertà gli altri link, pulsanti, 
ecc.. 

Naturalmente la comunicazione asincrona con 
il server avviene tramite il sopracitato oggetto 
XmlHttpRequest, che com'è ovvio deve essere 
supportato dal browser che lo utilizza. A que- 
sto riguardo, va rimarcato che la maggior parte 
dei browser supporta XmlHttpRequest nativa- 
mente, tranne Internet Explorer fino alla ver- 



EQUISITI PER L'UTILIZZO 
EMPI 



Sul CD allegato è disponibile 
una cartella che contiene la chat 
oggetto dell'articolo. Per poter 
far funzionare correttamente 
l'applicazione occorre aver 
installato sul proprio PC Php 
versione > 5.0, MySql e Apache. 
E' richiesto anche il supporto 
alla libreria Mysqli (mysql 
improved), che fornisce un 
accesso a MySql orientato agli 
oggetti. Per abilitare la libreria 



(sempreché ovviamente essa sia 
presente tra le estensioni 
attivabili), è sufficiente di solito 
decommentare (o 
eventualmente aggiungere) la 
riga "extension=php_mysqli.dll" 
nel php. ini. Una volta copiata la 
cartella nella directory di 
Apache, quindi, bisogna creare 
un nuovo db di nome Ajax ed 
eseguire lo script Sql per creare 
la tabella. 



sione 6.0 che invece utilizza al suo posto un 
ActiveXObject (non vi sono comunque diffe- 
renze di rilievo nel comportamento dei due 
oggetti, cambia soltanto il codice Javascript 
che li implementa). 

Un'altra considerazione importantissima di cui 
tenere conto è la necessità di sincronizzare i 
metodi che utilizzano XmlHttpRequest: è bene 
puntualizzare, infatti, che se l'oggetto è già 
impegnato in una transazione, non è possibile 
cercare di riutilizzarlo fino a che questa non è 
terminata: in caso contrario verrà generato un 
errore e la richiesta, ovviamente, fallirà. Al fine 
di creare applicazioni thread-safe, pertanto, è 
necessario interrogare lo stato del parametro 
readyState, che può assumere diversi valori: 

Uninitialized: l'oggetto esiste, ma non è 
ancora stata posta in essere una comunica- 
zione; 

1 Open: è stato richiamato il metodo open(), 
per instaurare una comunicazione; 

2 Sent: il metodo send() è stato eseguito ed ha 
inviato i dati (tramite GET o POST); 

3 Receiving: la risposta è in fase di ricezione da 
parte del client; 

4 Loaded: l'operazione termina: è l'unico 
stato, in pratica, che è supportato allo stesso 
modo da tutti i browser, e consente di sapere 
quando l'oggetto XmlHttpRequest è libero 
per poter essere riutilizzato. 

Ma come facciamo in un'applicazione pratica, 
com'è la nostra chat, a gestire correttamente lo 
stato di XmlHttpRequest senza correre il 
rischio di perdere delle comunicazioni ? 
Se tentiamo, infatti, di usare tale oggetto men- 
tre è già occupato, e ci limitiamo a controllare 
preventivamente il suo stato, tutto ciò che 
otterremo in caso di esito negativo del control- 
lo è evitare di incorrere in errori di Ajax, ma 
non avremo comunque risolto il problema 
della richiesta che non è andata a buon fine. 
Per risolvere questo problema abbiamo quindi 
diverse alternative: 

• se non è poi così importante la perdita di tale 
richiesta, possiamo semplicemente limitarci 
a gestire l'errore; 

• altrimenti possiamo creare più istanze del- 
l'oggetto XmlHttpRequest, una per ogni 
richiesta, avendo quindi la certezza che que- 
ste non andranno in conflitto tra di loro; 

• visto che creare troppe istanze dell'oggetto 
XmlHttpRequest può rallentare molto l'ese- 
cuzione del codice, allora forse è meglio, in 
caso di oggetto già impegnato, eseguire un'i- 
struzione setTimeout che, dopo un certo 
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tempo prefissato, riesegue la chiamata alla 
stessa funzione in modo asincrono per veri- 
ficare se l'oggetto nel frattempo si è disim- 
pegnato; 
• il metodo appena illustrato è perfetto nella 
maggior parte dei casi perché consente ad 
una funzione che cerca di impegnare un 
oggetto XmlHttpRequest di richiamare se 
stessa per un numero indefinito di volte fino 
a che questa non trova l'oggetto libero; ciò 
che tuttavia esso non è in grado di controlla- 
re è l'esatto ordine delle richieste inviate, 
che si può avere solamente implementando 
un meccanismo simile ad una coda. In prati- 
ca, prima di inviare le richieste, queste ven- 
gono impilate in un array di Javascript; la 
funzione che invia le richieste al server, 
quindi, comincerà la propria attività da 
quella più vecchia (sfruttando il principio 
del FIFO -> First In, First Out), quindi al ter- 
mine del processamento di questa passerà 
alla seconda, ecc.. In questo modo siamo 
certi che verrà rispettato l'esatto ordine delle 
richieste. 

Nel caso della nostra chat, in particolare, ci avvar- 
remo di un oggetto XmlHttpRequest, che gestisce 
l'invio e la ricezione dei messaggi. Per sincronizza- 
re l'accesso aH'XmlHttpRequest sfrutteremo una 
combinazione degli ultimi due metodi appena 
illustrati (setTimeout + cache): su pressione del 
pulsante di Invio del messaggio, il contenuto della 
casella di testo non sarà direttamente inviato al 
server, ma verrà accodato all'interno di un array; 
periodicamente, poi, verrà eseguita una funzione 
che preleva di volta in volta l'elemento della coda 
più vecchio e lo spedisce al server (sempre che 
l'oggetto XmlHttpRequest non sìa già impegnato 
altrove, altrimenti l'istruzione setTimeout si limita 
a ritentare la chiamata alla stessa funzione in 
modo asincrono dopo un certo periodo, per verifi- 
care nuovamente lo stato dell'oggetto). 
Non ci resta ora che gestire il risultato ritornato 
dall'elaborazione lato- server: è possibile, a questo 
scopo, utilizzare il parametro responseText, che 
recupera la risposta senza tenere conto della reale 
natura della stessa (file di testo, XML, html, ecc.). 
In questo modo, semplicemente, possiamo usare il 
metodo innerHtml di un div per aggiornare dina- 
micamente il suo contenuto sulla base del testo 
generato dal server. Ma possiamo anche richiede- 
re a quest'ultimo di generare un file XML come 
risposta da ritornare al client: il formato XML, 
come sappiamo bene, è estremamente versatile, e 
ci consente il rapido reperimento delle informa- 
zioni che ci servono semplicemente effettuando 
un'operazione di parsing (sempreché tale file sia 
formattato correttamente). Nel caso della nostra 



chat mi sono avvalso di questa seconda opportu- 
nità, utilizzando quindi il parametro responseXml. 
Non resta ora che buttare giù qualche riga di 
codice, tuttavia per ragioni di spazio mi limito 
a riportare solo il codice Javascript più impor- 
tante e la funzione PHP che gestisce le varie 
richieste effettuate dall'utente: 

// questa funzione esegue chiamate asincrone nei 

confronti del server 



// 



allo scopo di ottenere i nuovi messaggi 
function aggiorna_chat() 

{ 
var utente = 

document.getElementById("utente").value; 
var parametri = ""; 
// se l'oggetto XmlHttpRequest è stato istanziato 

correttamente... 
if(xml_Messaggi) 

{ 
try 



// il presente controllo evita che si cerchi 

di effettuare una nuova operazione 
// con l'oggetto xmlHttp_Messaggi se 

questo è già impegnato 
if (xml_Messaggi.readyState == 4 || 
xml_Messaggi.readyState == 0) // il 

controllo viene in ogni caso eseguito 
// se l'oggetto esiste ma non è 

stato ancora utilizzato 

{ 
// estraggo dalla cache il messaggio più 

vecchio, se questa contiene messaggi 

// La cache funziona un po' come 

la coda che facciamo al supermercato: il primo che 

// arriva ovviamente è anche il 

primo ad essere servito, cosicché siamo sicuri 

// che i messaggi vengono 

ricevuti nell'ordine esatto in cui essi sono inviati 

// Se la cache è piena estraggo 
l'elemento più vecchio allocato in essa e mando 
// la richiesta al server di 
visualizzarlo nella chat, recuperandolo tramite l'id del 
// messaggio. In caso contrario, 
semplicemente richiedo al server i nuovi messaggi 




S'E AJAX ? 



Ajax è l'acronimo di 
Asynchronous JavaScript And 
XML (Javascript asincrono e XML). 
Tale denominazione, usata per la 
prima volta da Jesse Garrett nel 
2005 all'interno di un suo blog, 
sta a sottolineare come 
l'obiettivo di questa nuova 
concezione preveda l'utilizzo di 



Javascript asincrono interfacciato 
con XML, migliorando quindi 
notevolmente l'interazione tra 
client e server e avvicinando 
sempre di più il mondo dello 
sviluppo web classico a quello 
molto più specializzato delle 
applet Java o delle tecnologie 
Macromedia Flash. 
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if (cache. length>0) 




{ 



parametri = cache. shiftQ; 



} 



else 



parametri = "richiesta=nuovi_messaggi&id = " 

+ultimo_id; 



} 



xml_Messaggi.open("POST", "chat.php", true); 
xml_Messaggi.setRequestHeader("Content- 

Type", "application/x-www-form-urlencoded"); 
xml_Messaggi.onreadystatechange = 

gestisci_risposta; 

xml_Messaggi.send(parametri); 

} 
else 

{ 
setTimeout("aggiorna_chat();", intervallo); 

} 

} 

catch(e) 

{ 
alert("Errore nel tentativo di recuperare i nuovi 

messaggi ..."); 
} 

_} 

} 

/* questa funzione PHP è specializzata nel gestire le 
richieste dei nuovi messaggi */ 
public function restituisci_nuovi_messaggi($id) 

{ 
$id = $this->connessione- 

>real_escape_string($id); 
if($id>0) 

{ 

$query = 



SA SONO I FRAME? 



I fratrie, che ho utilizzato nella 
prima chat di esempio di questo 
articolo, consentono di 
suddividere la pagina web in più 
riquadri, che possono puntare 
ciascuno ad una pagina web 
diversa. Essi consentono, ad 
esempio, di effettuare il refresh 
di uno solo di questi riquadri, 
senza dover per forza ricaricare 
tutta la pagina. Accanto a questo 
incontestabile pregio, tuttavia, 
l'uso dei frame presenta tutta 
una serie di difetti legati 
soprattutto alla complessità di 
progettazione della pagina, e al 
fatto che la suddivisione in più 
riquadri indipendenti gli uni 
dagli altri rompe la struttura 



classica del documento Html, 
generando vari problemi di 
interpretazione da parte di alcuni 
browser in certe situazioni (es. il 
salvataggio della pagina nei 
segnalibri, ecc.). Nel 1996 
Microsoft introdusse in Internet 
Explorer 3.0 gli iframe, più 
semplici e immediati nell'utilizzo 
rispetto ai precedenti, che subito 
alcuni programmatori 
impiegarono per simulare (in 
maniera abbastanza sporca, 
tuttavia) un'interazione 
trasparente con il server: ciò 
avveniva semplicemente 
modificando l'attributo src della 
pagina inclusa nell'iframe in 
questione. 
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'select id_messaggio, utente, messaggio, 
date_format(ora, "%Y-%m-%d %H:%i:%s") as ora 

' from chat where id_messaggio > ' . $id . 
' order by id_messaggio asc'; 

} 
else 



{ 



$query 



select * from chat order by id_messaggio asc'; 



> 



$result = $this->connessione->query($query); 
$risposta = '<?xml version = "1.0" 

encoding = "UTF-8" standalone="yes"?>' 



$risposta .= '<risposta>'i 



if($result->num_rows) 



{ 



while ($riga = $result- 

>fetch_array(MYSQLI_ASSOC)) 



{ 



$id = $riga['id_messaggio']; 



$utente = htmlspecialchars ($riga['utente']); 
$ora = htmlspecialchars ($riga['ora']); 
$messaggio = htmlspecialchars 

($riga['messaggio']); 



$risposta 



'<id>' . $id . '</id>' 



'<ora>' . $ora . '</ora>' 



'<utentex![CDATA[' . $utente . 

']]></utente>' . 
'<messaggiox![CDATA[' . 
$messaggio . ']]></messaggio>'; //con CDATA non 
dobbiamo preoccuparci 



//dei simboli che 
inseriamo nell'XML, 



//siano essi entità o 

altro 



} 



$result->close(); 



> 



$risposta = $risposta . '</risposta>'; 
return $risposta; 



} 



CONCLUSIONI 

Gli esempi presenti nel CD, lasciati volutamente 
abbastanza scarni dal punto di vista delle fun- 
zionalità trattate, abbracciano tuttavìa la mag- 
gior parte delle problematiche connesse con la 
programmazione Ajax, e consentono, con faci- 
lità, di iniziare subito a lavorare con questa 
intrigante filosofia legata allo sviluppo web: una 
filosofia che, sicuramente, costituirà il futuro 
dell'intero mondo delle Rich Internet 
Applications. 

Enrico Viale 
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US COME APACHE 
CON L'URL REWRITING 

SI TRATTA DI UNA DELLE FUNZIONALITÀ PIÙ AMATE DAGLI UTILIZZATORI DEL NOTO WEB 
SERVER OPENSOURCE. CONSENTE DI ELIMINARE I PARAMETRI LUNGHISSIMI CHE 
SOLITAMENTE CARATTERIZZANO UNA QUERY_STRING. CREIAMONE UNO PER MS 



.net 



LI CD U WEB 

mod_rewrite.zip 



^ 



in 
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rZ SQL Server, .Net 

- Framework 2.0 



<£ 



SQL Server 2005, 
Visual Studio 2005 



00000 



Ormai la maggior parte dei siti web si appog- 
gia a database per quanto riguarda i conte- 
nuti. Se, da un lato, si hanno notevoli van- 
taggi in termini di funzionalità e semplicità di 
gestione, è anche vero che c'è un prezzo da pagare... 
Pensiamo al sito web di una società che vende pro- 
dotti hi-tech online. Tipicamente i prodotti saranno 
suddivisi in categorie e sottocategorie (es. software - 
antivirus). La pagina che visualizza i prodotti di una 
sottocategoria sarà ad esempio: http://nomesito. 
com/prodotti.aspx?cat id=104&sca id=827 . Uri di que- 
sto tipo presentano due inconvenienti: 

• sono difficilmente memorizzabili dall'utente 

• sono penalizzanti nell'indicizzazione sui motori 
di ricerca 

Dal punto di vista dell'utente, sarebbe meglio poter 
digitare un uri del tipo http://nomesito. com/prodotti/ 
software/antivirus/ invece di quello visto sopra. 
Inoltre, probabilmente la società proprietaria del 
sito spenderà consistenti cifre in pubblicità e desti- 
nerà una porzione di budget all'indicizzazione sui 
motori di ricerca. Molti spider faticano ad indicizza- 
re correttamente pagine dinamiche, preferendo uri 
statici che non fanno uso di caratteri come ?, &, +, = 
ed altri legati alla costruzione classica di pagine 
dinamiche. Una possibile soluzione al problema 
consiste nell'implementare un modulo http che 
"intercetti" le richieste fatte al server, le "decodifichi" 
in base a delle regole e "rediriga" l'utente verso la 
risorsa desiderata. Questa tecnica prende il nome di 
"URL Rewriting". 



CONVERTIAMO 
GLI INDIRIZZI 

Lo scopo dell'articolo è abbastanza semplice. 
L'applicazione riceverà URL del tipo http://nomesito 
/param1/param2 dove parami e param2 sono percor- 
si fisicamente inesistenti, e li convertirà in indirizzi 
comprensibili e reali del tipo http://nomesito 



?param1=param2 

Prima di partire con lo sviluppo del modulo realiz- 
ziamo lo scheletro dell'applicazione su cui quest'ul- 
timo verrà testato. Apriamo Visual Studio e creiamo 
un nuovo sito web in linguaggio Visual Basic e chia- 
miamolo RewriteTestVB. Aggiungiamo al progetto 
un file di configurazione per l'applicazione 
(web.config) e nella sezione <confìguration> scri- 
viamo: 

<configSections> 

<sectionGroup name="mod_rewrite"> 

<section name="simple_rules" type=" System. 
Configuration.NameValueSectionHandler" /> 
<section name="regex_rules" type="System. 

Configuration.NameValueSectionHandler" /> 
</sectionGroup> 
</configSections> 

Abbiamo definito delle nuove sezioni del web.config 
(simple_rules e regex_rules) che ci serviranno per 
inserire le regole. Inseriamo quindi i nostri set di 
regole tramite delle coppie chiave valore, in cui 

• key = uri digitato 

• value = uri vero su cui fare il rewrite 

<mod_rewrite> 

<simple_rules> 

<add key= I 7RewriteTestVB/Home/" 
value=7RewriteTestVB/Default.aspx?tab=Home" /> 

<add key= I 7RewriteTestVB/Home" 
value=7RewriteTestVB/Default.aspx?tab=Home" /> 
<add key=7RewriteTestVB/ChiSiamo/" 
value=7RewriteTestVB/Default.aspx?tab=ChiSiamo "/> 

<add key=7RewriteTestVB/ChiSiamo" 
value=7RewriteTestVB/Default.aspx?tab=ChiSiamo" /> 
<add key=7RewriteTestVB/DoveSiamo/" 
value=7RewriteTestVB/Default.aspx?tab=DoveSiamo" /> 

<add key=7RewriteTestVB/DoveSiamo" 
value=7RewriteTestVB/Default.aspx?tab=DoveSiamo" /> 

<add key=7RewriteTestVB/Contattaci/" 
value=7RewriteTestVB/Default.aspx?tab=Contattaci" /> 
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<add key="/RewriteTestVB/Contattaci" 
value="/RewriteTestVB/Default.aspx?tab=Contattaci" /> 
<add key="/RewriteTestVB/Categorie/" 

value="/RewriteTestVB/Categorie.aspx" /> 
<add key="/RewriteTestVB/Categorie" 

value="/RewriteTestVB/Categorie.aspx" /> 
</simple_rules> 
<regex_rules> 

<add key="/RewriteTestVB/Sottocategorie/(.*)/" 

value= l 7RewriteTestVB/Sottocategorie.aspx?cat=$l" /> 

<add key="/RewriteTestVB/Sottocategorie/(.*)" 

value= I 7RewriteTestVB/Sottocategorie.aspx?cat=$l" /> 

<add key="/RewriteTestVB/Prodotti/(. *)/(.*)/" 

value=7RewriteTestVB/Prodotti.aspx?cat=$l&amp 

;scat=$2" /> 
<add key="/RewriteTestVB/Prodotti/(. *)/(.*)" 
value=7RewriteTestVB/Prodotti.aspx?cat=$l&amp 

;scat=$2" /> 
<add key=7RewriteTestVB/DettagliProdotto/(.*)/" 
value="/RewriteTestVB/DettagliProdotto.aspx?pro=$r /> 

<add key=7RewriteTestVB/DettagliProdotto/(.*)" 
value=7RewriteTestVB/DettagliProdotto.aspx?pro=$r /> 

</regex_rules> 
</mod_rewrite> 

Abbiamo definito due set di regole. Il primo, chia- 
mato simple_rules, contiene le regole statiche che 
mappano le pagine Home, ChiSiamo, DoveSiamo, 
Contattaci e Categorie con la Default. aspx a cui 
viene passato un valore "tab" nella QueryString. 
Il secondo, regex_rules, contiene le regole dinami- 
che, create utilizzando delle semplici regular expres- 
sions. Prendiamo, ad esempio, la regola che mostra i 
prodotti: 

• Prodotti/ (.*)/(.*)/ 

• Prodotti. aspx?cat=$l&scat=$2 

Permette di trasformare uri del tipo Prodotti/CODI- 
CE1/CODICE2/ in uri del tipo Pro dotti. aspx?cat= 
CODICEl&scat= CODICE2. Per il momento 
possiamo chiudere il file web.config. Adesso che lo 
scheletro dell'applicazione è pronto, passiamo alla 
realizzazione del modulo HTTP che si occuperà di 
effettuare il "rewrite" degli uri. 



HTTPHANDLERS 
ED HTTPMODULES 

I Web Server utilizzano dei componenti per estende- 
re le proprie funzionalità base. US, ad esempio, uti- 
lizza una tecnologia chiamata ISAPI (acronimo di 
Internet Server API) ed, in particolare, le "ISAPI 
Extensions" e gli "ISAPI Filters". Le prime sono delle 
applicazioni che estendono le funzionalità del ser- 
ver: vengono implementate tramite delle dll e pos- 
sono essere eseguite in seguito a richieste del client; 



i secondi sono dei filtri applicati alle richieste http. 
Microsoft .Net fornisce HttpModules ed 
HttpHandlers per realizzare questo tipo di funziona- 
lità. Quando una richiesta arriva al Web Server, viene 
processata da eventuali moduli HTTR gestita da un 
solo handler ed, infine, la risposta viene inviata al 
client. 



CREIAMO IL MOSTRO 
MODULO HTTP 

I moduli HTTP sono dei componenti che imple- 
mentano l'interfaccia IHttpModule del namespace 
System. Web. Questa interfaccia contiene due meto- 
di che sono: Init e Dispose. Il metodo Init consente 
al modulo di registrare i gestori di eventi dell'appli- 
cazione; il Dispose viene eseguito per liberare le 
risorse. Aggiungiamo un nuovo progetto di tipo 
"Visual Basic Class Library" alla solution creata. Per 
farlo, clicchiamo con il tasto destro del mouse sul 
nome della solution e selezioniamo "Add" -> "New 
Project"; dalla maschera successiva scegliamo il tipo 
di progetto e diamogli come nome 
"mod_rewrite_vb" Rinominiamo Class2.vb in 
Rewriter.vb. Ecco il codice della classe: 

Imports System 

Imports System. Web 

Imports System. Collections.Specialized 

Imports System. Configuration 

Imports System. Text.RegularExpressions 

Public Class rewriter 

Implements IHttpModule 
Public Sub Init(ByVal App As 
HttpApplication) Implements IHttpModule. Init 
AddHandler App.BeginRequest, 

AddressOf RewriteJJrl 
End Sub 
Public Sub Rewrite_Url(ByVal sender As 

Object, ByVal args As System. EventArgs) 
Dim App As HttpApplication = 

CType(sender, HttpApplication) 
Dim PageName As String = 

App.Request.Path.ToLower() 
'Regole semplici 
Dim simple_rules As 

NameValueCollection = 
CType(ConfigurationManager.GetSection("mod_rew 
rite/simple_rules"), NameValueCollection) 
If Not simple_rules Is Nothing Then 
For i As Integer = 

To simple_rules.Count - 1 
Dim Source 
As String = simple_rules.GetKey(i).ToLower() 
Dim 
simple_rules.Get(i) 




Destination As String 



If PageName = Source Then 
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App.Context.RewritePath(Destination) 
Exit For 
End If 
Next 
End If 



'Regex 



Dim regex_rules As 

NameValueCollection = 
CType(ConfigurationManager.GetSection("mod_rew 
rite/regex_rules"), NameValueCollection) 
If Not regex_rules Is Nothing Then 
For i As Integer = 
To regex_rules.Count - 1 
Dim Rule As 
Regex = New Regex(regex_rules.GetKey(i), 
RegexOptions.IgnoreCase) 
Dim Matchl 
As Match = Rule.Match(PageName) 
If Matchl. Success Then 
App.Context.RewritePath(Rule.Replace(PageName, 

regex_rules.Get(i))) 
Exit For 

End If 
Next 
End If 
End Sub 
Public Sub Dispose() Implements 

IHttpModule. Dispose 
End Sub 



^ 




End Class 




Tutto il codice 

dell'articolo è scritto 

in Visual Basic, nel CD 

allegato alla rivista è 

comunque contenuto 

l'intero progetto 

scritto in C#. 






Fig. 2: Creiamo il nostro HttpModule 

Abbiamo importato quattro namespace: 

• System.Web: contiene l'interfaccia IHttpModule. 




PACHE E MOD REWRITE 



Apache HTTP Server è uno dei 
Web Server più diffusi al mondo. 
Nasce nel 1995 grazie al lavoro di 
una fondazione no-prof it 
chiamata "Apache Software 
Foundation" e si diffonde in tutto 
il mondo per la sua affidabilità e 



le elevate performance. 
Tra i moduli più utilizzati in 
Apache ne troviamo uno 
chiamato mod_rewrite che 
utilizza un motore di riscrittura 
basato su un parser di regular 
expression. 



J 



• System.Confìguration: contiene la classe 
ConfigumtionManager che ci permetterà di leg- 
gere dal web.config. 

• System.Collections.Specialized: contiene la clas- 
se NameValueCollection per leggere le sezioni del 
web.config. 

• System.Text.RegularExpressions: per le espres- 
sioni regolari. 

La classe implementa l'interfaccia IHttpModule e 
deve quindi definire i metodi Init e Dispose. 
Il metodo Init è molto semplice, contiene infatti una 
sola riga: 

AddHandler App.BeginRequest, AddressOf RewriteJJrl 

che registra un gestore per l'evento BeginRequest, 
associandogli il metodo RewriteJJrl. Il metodo 
verrà attivato ad ogni richiesta di pagina. 
Il metodo RewriteJJrl è il nucleo del modulo: si 
occupa di leggere e processare le regole, e, in caso di 
corrispondenze tra gli uri digitati e le pagine richie- 
ste, riscrivere i path. 
Nelle prime due righe del metodo: 

Dim App As HttpApplication = CType(sender, 

HttpApplication) 
Dim PageName As String = 

App. Request. Path. ToLower() 

instanziamo un oggetto di tipo HttpApplication e lo 
utilizziamo per ottenere il percorso della pagina 
richiesta al server. 

Abbiamo poi due sezioni distinte: la prima si occu- 
pa di leggere le regole statiche; la seconda di leggere 
quelle che fanno uso delle espressioni regolari. 
In entrambe instanziamo un oggetto di tipo 
NameValueCollection che conterrà i valori presenti 
nelle section create in precedenza nel web.config. 
Ne "ridiamo" quindi il contenuto per controllare se 
ci sono corrispondenze. 
Per le regole semplici: 

Dim Source As String = 

simple_rules.GetKey(i).Tol_ower() 
Dim Destination As String = simple_rules.Get(i) 
If PageName = Source Then 

App.Context.RewritePath(Destination) 



Exit For 



End If 

controlliamo se la pagina che abbiamo digitato è 
presente tra le regole (leggendo il valore key della 
regola) e, se lo è, riscriviamo il path (utilizzando il 
path presente nel campo value della regola). 
Per le regole dinamiche invece: 
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Dim Rule As Regex = New 



Regex(regex_rules.GetKey(i), 
RegexOptions.IgnoreCase) 



Dim Matchl As Match = Rule.Match(PageName) 



If Matchl. Success Then 



App.Context.RewntePath(Rule.Replace(PageName, 

regex_rules.Get(i))) 



Exit For 



End If 

utilizziamo la classe Regex per controllare se le 
regole scritte tramite regular expressions hanno un 
"match" con la pagina richiesta e, in caso affermati- 
vo, viene effettuato il rewrite. 
In entrambi i casi utilizziamo il metodo 
RewritePath per riscrivere dinamicamente il path. 



CONFIGURIAMO 

LA WEB APPLICATION 

Una volta creato il modulo HTTR occorre registrar- 
lo nella nostra applicazione web. Farlo è semplice, 
basta aggiungere poche righe nel file web.config. 
Compiliamo la libreria mod_rewrite_vb.dll ed 
aggiungiamone la reference al progetto 
RewriteTestVB. Per farlo, clicchiamo con il tasto 
destro del mouse sulla solution e quindi su "Add" -> 
"Reference". Clicchiamo su "Browse" e scegliamo il 




Fig. 3: Importiamo la libreria 

file mod_rewrite_vb.dll. Importata la libreria, 
occorre dire all'applicazione che deve utilizzarla 
come modulo HTTP. Per farlo, apriamo il file 
web.config ed aggiungiamo le seguenti righe nella 
sezione system. web: 

<httpModules> 
<add 
type="mod_rewnte_vb.rewriter,mod_rewnte_vb" 
name="mod_rewrite_vb" /> 
</httpModules> 

l'attributo type specifica il tipo di modulo HTTP in 



termini di classe ed assembly; l'attributo name spe- 
cifica il nome del modulo. 

Una volta registrato l'assembly, possiamo creare le 
pagine del nostro sito dei prodotti. 
Come prima cosa, creiamo un controllo 
"Menu.ascx" che inseriremo in tutte le pagine. 



<%@ Control Language= 


= "VB" 








AutoEventWireup= 


'false" 


CodeFile= 


"Menu.ascx.vb" 






Inherits="Menu' 


%> 



<asp:Menu id="Menul" runat="server" 

ForeColor="#284E98" Font-Names="Verdana" 

StaticSubMenuIndent="10px" Font-Size="X-Small" 

DynamicHorizontalOffset="2" 

BackColor="#B5C7DE"> 

<StaticMenuItemStyle Font-Names="Verdana" Font- 

Size="X-Small" HorizontalPadding="5px" 
VerticalPadding="2px" /> 
<DynamicHoverStyle BackColor="#284E98" 

ForeColor="White" /> 
<DynamicMenuStyle BackColor="#B5C7DE" /> 
<StaticSelectedStyle BackColor="#507CDl" /> 
<DynamicSelectedStyle BackColor="#507CDl" /> 
<DynamicMenuItemStyle HorizontalPadding="5px" 

VerticalPadding="2px" /> 
<Items> 

<asp:MenuItem 
NavigateUrl=7RewriteTestVB/Home" Text="Home 
Page" Value="Home Page"> 
</asp:MenuItem> 
<asp:MenuItem Text="Società" 

Value="Società"> 
<asp:MenuItem 
NavigateUrl=7RewriteTestVB/ChiSiamo" Text="Chi 
Siamo" Value="Chi Siamo"> 
</asp:MenuItem> 
<asp:MenuItem 
NavigateUrl=7RewriteTestVB/DoveSiamo" 
Text="Dove Siamo" Value="Dove Siamo"> 
</asp:MenuItem> 
<asp:MenuItem 
NavigateUrl="/RewriteTestVB/Contattaci" 
Text= "Contatti" Val uè = "Contatti "> 
</asp:MenuItem> 
</asp:MenuItem> 
<asp:MenuItem 
NavigateUrl=7RewriteTestVB/categorie.aspx" 




B.CONFIG 



Il web.config è un file di 
configurazione delle applicazioni 
.Net. E' un file XML diviso in 
sezioni, ciascuna della quali ha un 
compito ben preciso. Tra le 
principali ricordiamo 
<appsettings> in cui inseriamo 




delle variabili di configurazione 

che potranno essere lette a 

runtime. 

E' possibile accedere in modo 

programmatico alle parti del 

web.config utilizzando il 

namespace System.Configuration. 
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Text= 


'Prodotti" Value= 


" Prodotti" > 




</asp:MenuItem> 


</Items> 


<StaticHoverStyle BackColor= 


="#284E98" 

ForeColor= 


"White" /> 


</asp:Menu> 



Il controllo contiene la lista dei link "statici". 
Creiamo i seguenti file: 

• Default, aspx 

• Categorie, aspx 

• SottoCategorie.aspx 

• Prodotti, aspx 

Il file Default, aspx verrà utilizzato per visualizzare le 
pagine di presentazione della nostra società. I con- 
tenuti saranno letti dalla tabella "Contents" del data- 
base ed il rewrite degli uri sarà fatto grazie alla sezio- 
ne "simple_rules" del web.config. 
Vediamo il codice della pagina: 



IbLtitolo.Text = 
reader("con_name").ToString() 



Page.Title = 
reader("con_name").ToString() 



lbl_page_html.Text = 
reader("con_content").ToString() 



End If 



Finally 



reader.CloseQ 



End Try 



Finally 



Conn.CloseQ 



End Try 

è molto semplice: legge dalla QueryString il valore di 
tab e carica i contenuti dal database. Fin qui niente 
di strano... il bello è che per richiamare la pagina "chi 
siamo" non occorre linkare 

/rewritetestvb/deafult.asxp?tab=chisiamo, ma è suf- 
ficiente scrivere /rewritetestvb/chisiamo e così per 
le altre pagine dell'area istituzionale. 
I link sono infatti 



Dim tab As String 



^ 



& 



If Not Request.QueryString("tab") Is Nothing Then 
tab = Request.QueryString("tab") 

Else 

tab = "Home" 
End If 
Dim Conn As SqlConnection = New 

SqlConnection(ConfigurationManager.ConnectionStrin 
gs("ConnectionString").ConnectionString) 
Try 
Conn.Open() 

Dim Sql As String = "select * 

from contents where 
con_short_name=@con_short_name" 
Dim Comm As SqlCommand = New 
SqlCommand(Sql, Conn) 
Comm.Parameters.Add(New 

SqlParameter("@con_short_name", tab)) 
Dim reader As SqlDataReader = 

Comm.ExecuteReaderO 
Try 

If reader. ReadQ Then 



EGULAR EXPRESSIONS 



Una regular expression è una 
stringa che, utilizzando dei 
caratteri particolari, riesce a 
descrivere un set di stringhe. 
Ad esempio l'espressione 
A \d{5}$, rappresenta un numero 
di 5 cifre (come un codice 
postale). 
In .Net c'è un namespace 



System. Text.RegularExpression 
s che contiene le classi per 
definire ed utilizzare le regular 
expressions. Le classi principali 
sono Regex, che rappresenta 
una espressione regolare, e la 
classe Match, che rappresenta 
il risultato del match di una 
regular expression. 






• Home Page -> /RewriteTestVB/Home/ 

• Chi Siamo -> /RewriteTestVB/ChiSiamo/ 

• Dove Siamo -> /RewriteTestVB/DoveSiamo/ 

• Contatti -> /RewriteTestVB/Contatti 

Passiamo alla parte prodotti. 
Le pagine in gioco sono: 

• Categorie.aspx: visualizza le categorie dei prodot- 
ti. 

• SottoCategorie.aspx: visualizza le sottocategorie 
di una categoria scelta. 

• Prodotti.aspx: visualizza i prodotti di una sottoca- 
tegoria. 

Le regole per la riscrittura degli uri sono quelle della 
sezione "regex_rules". 

Iniziamo con le categorie: la pagina in questione è 
Categorie.aspx che contiene, oltre al menu di navi- 
gazione, un GridView su cui vengono caricate le 
categorie prodotti. Il codice completo della pagina 
aspx ed il relativo vb, lo trovate nel ed allegato. 
E' utile analizzare il codice che crea i link alla pagina 
delle sottocategorie: 

Protected Sub grd_categorie_RowDataBound(ByVal 

sender As Object, ByVal e As 
System. Web. UI.WebControls.GridViewRowEventArgs) 
Handles grd_categorie.RowDataBound 
If e.Row.RowType = 

DataControlRowType.DataRow Then 
Dim lbl_cat_short_name As Label = 
CType(e.Row.Cells(0).FindControl("lbl_cat_ 
short_name"), Label) 
Dim anc_sca As HtmIAnchor = 
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CType(e.Row.Cells(l).FindControl("anc_sca"), 

HtmlAnchor) 
anc_sca.HRef = 
"../Sottocategorie/" + lbl_cat_short_name.Text + "/" 
End If 
End Sub 

Non fa altro che leggere il nome della categoria e 
creare dei link del tipo Sottocategorie/Nome_ 
Categoria; sarà il nostro modulo "rewrite" ad occu- 
parsi di riscrivere l'uri come Sottocategorie.aspx? 
cat= Nome_Categoria 

La pagina Sottocategorie.aspx funziona allo stesso 
modo della pagina Categorie. aspx, e contiene una 
serie di link (anche questi riscritti dal nostro modu- 
lo) alla pagina Prodotti. aspx . 
Vediamo, infine la pagina dei prodotti. Il codice 
completo si trova nel CD allegato. 
La pagina contiene una Label in cui scriveremo 
categoria e sottocategoria corrente ed un GridView 
in cui andremo a caricare la lista dei prodotti. 
Nell'evento Page_Load leggiamo categorie e sotto- 
categoria dalla QueryString e lanciamo i tre metodi 
sotto riportati: 

Private Function getCategory(ByVal Conn As 

SqlConnection, ByVal cat As String) As String 
Dim Sql As String = "select cat_name from 

Categories where cat_short_name=@cat" 
Dim Comm As SqlCommand = New 

SqlCommand(Sql, Conn) 
Comm.Parameters.Add(New 

SqlParameter("@cat", cat)) 



Return 



Convert.ToStnng(Comm.ExecuteScalar()) 



End Function 



Private Function getSubCategory(ByVal Conn As 

SqlConnection, ByVal scat As String) As String 
Dim Sql As String = "select sca_name from 
SubCategories where sca_short_name=@scat" 
Dim Comm As SqlCommand = New 

SqlCommand(Sql, Conn) 
Comm.Parameters.Add(New 

SqlParameter("@scat", scat)) 



Return 



Convert.ToString(Comm.ExecuteScalar()) 



End Function 



Private Sub FillProductsGrid(ByVal Conn As 

SqlConnection, ByVal cat As String, ByVal scat As 

String) 



Dim Sql As String : 



1 SELECT" & . 



" pro_name Nome, pro_model 

Modello, " &. 



pro_description Descrizione, pro_price Prezzo" & . 



FROM Products" & . 



1 INNER JOIN Categories" & . 



INNER JOIN SubCategories" &. 



ON pro_sca_id = sca_id" & . 



WHERE" &. 



cat_short_name = @cat" & . 



AND sca_short_name : 



@scat" 



Dim Comm As SqlCommand = New 

SqlCommand(Sql, Conn) 
Comm.Parameters.Add(New 

SqlParameter("@cat", cat)) 
Comm.Parameters.Add(New 

SqlParameter("@scat", scat)) 
Dim myDataAdapter As SqlDataAdapter = 

New SqlDataAdapter(Comm) 
Dim table As DataTable = New DataTableQ 



myDataAdapter. Fill(table) 



myDataAdapter. Dispose() 



grd_prodotti.DataSource = table 



grd_prodotti.DataBind() 



End Sub 

getCategory restituisce il nome della categoria 
getSubCategory restituisce il nome della sottocate- 
goria FillProductsGrid riempie la griglia con la lista 
dei prodotti. Se eseguiamo il progetto e clicchiamo 
su qualche link, possiamo notare come sulla barra 
degli indirizzi vengano sempre visualizzati gli indi- 
rizzi "user friendly" invece di quelli reali. 



CONCLUSIONI 

Con ASP 3 l'unico modo per realizzare l'uri rewriting 
era scrivere un filtro ISAPI ed installarlo su US; una 
soluzione spesso irrealizzabile soprattutto se non si 
aveva accesso alla configurazione del server. Con 
.Net si hanno molte possibilità in più. La possibilità 
di utilizzare moduli anche a livello della singola 
applicazione consente di avere una portabilità mag- 
giore delle proprie applicazioni rendendole meno 
dipendenti dalla configurazione del server su cui 
dovranno funzionare. 

Carmelo Scuderi 





Apache mod_rewrite 
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iki/Regular expression 
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lì Prodotti: Video - Televisori LCD - Microsoft Internet Explorer 



File Modifica Visualizza Prepariti Strumenti ? 
Indirizzo 



^) http://localhost: 1286/RewriteTestCS/Prodotti/video/lcd/ 



Categoria: Video 
SottoCategoria: Televisori LCD 



Home Page 


Nome Modello 


Descrizione 


Prezzo 


Società y 


Televisore 1 Modello TV 


Descrizione TV 


800,0000 


Prodotti 


Televisore 2 Modello TV 2 


Descrizione TV 2 


300,0000 



ON pro_cat_id = cat_id" & . 



Fig. 4: La pagina dei prodotti 
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JAVASCRIPT E LE 
REGULAR EXPRESSION 

IN QUESTO ARTICOLO APPRENDERETE COSA SONO LE ESPRESSIONI REGOLARI E COME 
UTILIZZARLE IN JAVASCRIPT. VEDREMO COME SARÀ POSSIBILE VALIDARE, LATO CLIENT, 
E-MAIL E QUANT ALTRO E COME ESTRARRE PARTI DI STRINGHE 




CI CD □ WEB 

JS-RegEx.zip 



Wgm 



in 




REQUISITI 



r*? Medie di JavaScript 




Un'espressione regolare (regex per gli 
amici) è una stringa che, utilizzando 
una speciale sintassi, identifica 
occorrenze di sottostringhe all'interno di una 
sequenza di caratteri. Per chiarire facciamo 
subito un esempio. Supponiamo che da una 
pagina HTML vogliamo estrarre tutti gli script 
contenuti nella stessa. La figura 1 dovrebbe 
chiarire il concetto. Sicuramente si può rag- 
giungere questo risultato senza utilizzare le 
regex. Basta scrivere decine di righe di codice 
che usano charAt, indexOf e substr ed il gioco 
è fatto. Se invece conoscete le regex potete 
ottenere lo stesso risultato utilizzando una 
riga di codice! Interessante vero? 



" '- * riftW*... ftiBWr... /-CI /«««.. 



ft - a 



- -B»p< ..te* 






Script Estratti: 

■ '■' *ej« di WBrt per tvotft fi Knp 



Fig. 1: Screenshot dell'applicazione 

Alla fine dell'articolo vedremo come sviluppa- 
re, per l'appunto, una pagina Web che, inse- 
rendo il codice HTML in una textarea, estrarrà 
tutti gli script contenuti nello stesso. Questa si 
rivelerà molto utile nel caso in cui volessimo 
"sniffare" gli script utilizzati da una pagina 
Web senza andare a trovarli "a mano" in 
mezzo al resto del codice. 
Bisogna dire che i concetti esposti in questo 
articolo, riguardo alle espressioni regolari, 



sono applicabili, apportando qualche piccolo 
accorgimento, a tutti quei linguaggi che sup- 
portano questa potente feature. Per i nostri 
scopi utilizzeremo JavaScript ce nella sua uni- 
versalità ci consente di illustrare la tecnica 
senza agganciarci alle peculiarità di linguaggi 
più asettici 



REGULAR EXPRESSION 
E JAVASCRIPT 

JavaScript supporta le regex attraverso la clas- 
se RegExp. Vi sono due versioni del costrutto- 
re di questa classe; una che accetta un solo 
parametro e un'altra due. Facciamo subito 
qualche esempio. 



var str 



"Mosca è una bella città" 



var regex = new RegExp("mosca"); 



if( regex. test(str)) 



alert("Trovata occorrenza della parola 

mosca"); 



else 



alert("Non è stata trovata alcuna 

occorrenza della parola mosca"); 

Eseguendo questo script noterete che verrà 
visualizzato il secondo alert, ovvero la parola 
non viene trovata. Questo perché, per default, 
le espressioni regolari sono case-sensitive. 
Notare, inoltre, l'uso del metodo test della 
classe RegExp. Tale metodo, restituisce true se 
e solo se il pattern trova almeno un match. Se, 
invece, si vuole che la ricerca non faccia diffe- 
renza tra maiuscole e minuscole, si può utiliz- 
zare la seconda forma del costruttore. Infatti, 
sarebbe bastato istanziare l'oggetto nel 
seguente modo: 

var regex = new RegExp("mosca" V); 

e sarebbe stato visualizzato il primo alert. La i 
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indica di fare una ricerca di tipo case-insensi- 
tive. In questo esempio la regex era costituita 
da una semplice stringa: "mosca". Come 
vedremo, però, la potenza delle espressioni 
regolari risiede nel fatto che è possibile utiliz- 
zare numerosi simboli per soddisfare i più 
svariati bisogni. Ad esempio, la seguente regex 
identifica tutte le parole che iniziano per m, 
finiscono per a e non fa differenze tra maiu- 
scole e minuscole: 

var regex = new RegExp("m\\w*a", "i"); 



alert(ret.toString()); 

noteremo che sarà visualizzato l'intero array 
di match trovati. È necessario ciclare attraver- 
so i risultati, poiché altrimenti sarebbe visua- 
lizzato di nuovo solo la prima occorrenza. 
Alternativamente ad exec è possibile utilizza- 
re il metodo match della classe String che per- 
mette di ottenere direttamente l'array conte- 
nente tutti i risultati. Non vi è quindi la neces- 
sità di ciclare per recuperare tutte le occorren- 
ze. Ad esempio: 



IjIJIkJM 


ssfc\ 


y 

Jaoasl 


Éipt 





Essa rappresenta, quindi, le seguenti parole: 
mosca, mora, marina, menta... ma anche 
Marina, MARta, ma, MA, mA ecc. Questo per- 
ché \w identifica la classe dei caratteri alfanu- 
merici, incluso Tunderscore. Il quantificatore 
* significa zero o più di ciò che lo precede; nel 
nostro caso zero o più caratteri alfanumerici o 
underscore. 

Non preoccupatevi però, spiegheremo più 
avanti le classi ed i quantificatori. 
A parte test, esiste un altro metodo della clas- 
se RegExp molto potente: exec. Tale metodo 
restituisce un array di stringhe contenente, 
all'indice 0, l'espressione trovata e nei 
seguenti indici gli eventuali gruppi (che 
vedremo in seguito). Se non trova nessun 
match, exec restituisce false. Rifacendoci 
all'esempio precedente: 

var str = "mosca, mora, marina, Alessandro, 

menta, ioProgrammo, Marina, MARta, ma, MA, 

mA"; 
var regex = new RegExp("m\\w*a", "i"); 
var results = regex. exec(str); 
alert(results.toString()); 

Eseguendo quest'esempio noterete che viene 
visualizzata solo la parola mosca. Perché? Il 
motivo risiede nel fatto che, per default, la 
regex identifica solo la prima occorrenza. Se si 
vuole indicare di trovare tutte le occorrenze, 
bisogna usare un'altra opzione. Tale opzione è 
g e sta per global. Modificando l'espressione 
regolare nel modo seguente: 



var str = "mosca, mora, marina, Alessandro, 

menta, ioProgrammo, Marina, MARta, ma, MA, 

mA"; 
var regex = new RegExp("m\\w*a", "gi"); 
var results = str.match(regex); 
alert(results.toString()); 

Nel caso in cui non si ha la necessità di utiliz- 
zare gruppi, consiglio di usare il metodo 
match. Da notare che tale metodo appartiene 
alla classe String, non a RegExp, ed accetta 
come parametro una regex. Vi sono altri due 
metodi molto utili della class String che accet- 
tano come parametro un'espressione regola- 
re. Essi sono replace e split. Il primo sostitui- 
sce tutte le occorrenze della prima stringa con 
la seconda. Ad esempio: 

var str = "mosca, mora, marina, Alessandro, 

menta, ioProgrammo, Marina, MARta, ma, MA, 

mA"; 
var regex = new RegExp("m\\w*a", "gi"); 
var results = str.replace(regex, "sostituita"); 
alert(results.toString()); 

Il risultato di questo script è visibile in figura 



[Applicazione JavaScript] 



A 



sostituita, sostituita, sostituita, Alessandro, sostituita, ioProgrammo, sostituita, sostituita, sostituita, 
sostituita, sostituita 



EZ] 



Fig. 2: Risultato dell'esecuzione dello script 



var regex = new RegEx 


p("m\\w*c 


", "gi"); 




e ciclando attraverso 


i risultati trovati: 




var ret = []; 


for(var results = regex 


exec(str); 
results = 


results != nuli; 
regex. exec(str)) 


{ 


ret.push(results); 


} 




ATTERRI E MATCH 



IÈ proprio vero! Alcune parole 
tecniche inglesi non sono 
direttamente traducibili in 
italiano. In quest'articolo uso 
spesso le parole pattern e 
match. Per pattern s'intende la 
regex vera e propria, ossia la 

^ 



stringa identificante 
l'espressione regolare, come ad 
esempio 02-\\d{5}. Per match 
s'intende che una stringa 
soddisfa la nostra regex. Ad 
esempio 02-12387 soddisfa il 
pattern 02-\\d{5}. 
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^ 



2. Come si può vedere, sono state sostituite 
tutte le occorrenze trovate. Il metodo split, 
invece, divide una stringa in sottostringhe e le 
ritorna come un array. Ad esempio: 

var str = "primo elemento-secondo 

elemento-terzo elemento"; 
var regex = new RegExp("-", "g"); 
var results = str.split(regex); 
alert(results.toString()); 

In questo esempio viene estratto un array 
contenente gli elementi che, in str, sono sepa- 
rati dal segno -. Il metodo split è molto utile 
nel caso in cui abbiamo a che fare con CSV. 



METACARATTERI, 
CLASSI DI CARATTERI 
E QUANTIFICATORI 

I metacaratteri, assieme a classi e quantifica- 
tori, sono i pilastri fondamentali delle espres- 
sioni regolari e questo a prescindere dal lin- 
guaggio di programmazione in uso. 
Un metacarattere non è nient'altro che un 
carattere che possiede un particolare signifi- 
cato all'interno di un'espressione regolare. I 
metacaratteri sono: 



var regex 



elemento|terzo elemento" 
new RegExp("\\l", "g"); 



( [ { \ 



I ) 



Scopriremo il significato di questi caratteri 
nel prosieguo dell'articolo. Per ora vi basti 
sapere che, se volete utilizzare uno di questi 
caratteri all'interno di una regex, dovrete 
farlo passare "inosservato" utilizzando il 
carattere di escape, cioè il back slash \. Ad 
esempio, se nello script precedente avessimo 
avuto stringhe separate dal carattere pipe, |, 
invece che dal segno -, allora avremmo dovu- 
to utilizzare l' escape per far funzionare le 
cose. 

var str = "primo elemento|secondo 



alasse 


Identifica 


Equivalente 


■ 


Qualsiasi carattere tranne \n e \r 


[ A \n\r] 


\d 


Qualsiasi numero 


[0-9] 


\D 


Qualsiasi carattere tranne numeri 


[ A 0-9] 


\s 


Uno spazio 


[ \n\r\t\f\xOB] 


\S 


Qualsiasi carattere tranne uno spazio 


[ A \n\r\t\f\xOB] 


\w 


Qualsiasi carattere alfanumerico 
e l'underscore 


[a-zA-Z0-9J 


\W 


La negazione di \w 


[ A a-zA-Z0-9J 


Tabella h Classi predefinite 



var results = str.split(regex); 



alert(results.toString()); 

È da notare una cosa importante, ovvero l'uti- 
lizzo del doppio back slash, \\. Questo è 
necessario perché se guardate i metacaratteri 
troverete che tra essi è presente anche il sim- 
bolo \. Quindi bisogna utilizzare il carattere 
di escape per far passare inosservato l'escape 
stesso. 

Oltre ai metacaratteri bisogna considerare 
altri speciali caratteri predefiniti come nuova 
linea o tab, rispettivamente \n e \t. Se dovete 
utilizzare tali sequenze all'interno delle regex, 
bisogna utilizzare l'escape. 
Passiamo ora alle classi. Una classe denota un 
insieme di caratteri. Le classi si indicano tra 
parentesi quadre. Ad esempio, 



var str 



"Mosca, Tosca, Ciao Mondo"; 



var regex = new RegExp("[mt]osca", "gi"); 
var results = str.match(regex); 
alert(results.toString()); 

Il precedente esempio trova due match: 
Mosca e Tosca. In sostanza quella regex signi- 
fica: trovami tutte (l'opzione g) le occorrenze 
di mosca e/o tosca (la classe [mt]) a prescin- 
dere dalle maiuscole e minuscole (l'opzione 
i). Vi consiglio di iniziare a ragionare in que- 
sto modo, ovvero a tradurre in parole le 
espressioni regolari che incontrate. 
Questo vi aiuterà a prendere dimestichezza 
con le stesse. 

L'uso delle classi non si limita a casi semplici. 
Potete indicare un range di caratteri. Ad 
esempio, la regex: 

var regex = new RegExp("[a-z]osca", "gi"); 

identifica tutte le parole che iniziano per 
qualsiasi carattere e terminano per osca. È 
anche possibile combinare più classi assie- 
me: 

var regex = new RegExp("[m-zl-9]osca", "gi"); 

Quest'esempio "matcha" tutte le parole che 
iniziano per m, n,...z oppure 1, 2,... ,9 e termi- 
nano in osca. 

È possibile, inoltre, utilizzare le negazioni. Ad 
esempio [ A a-d] identifica qualsiasi carattere 
tranne a, b, e, d. In definitiva, le classi di 
caratteri sono molto utili e potenti. 
I lettori dotati di buona memoria ricorderan- 
no che all'inizio ho utilizzato i caratteri \w 
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per identificare qualsiasi carattere alfanume- 
rico, incluso runderscore. Quella usata non è 
nient'altro che una classe predefinita. In pra- 
tica, è una sorta di scorciatoia. La tabella 1 
illustra tutte le classi predefinite e ne descri- 
ve il significato. 

Passiamo ora ai quantificatori. Come dice la 
parola stessa, i quantificatori ci permettono 
di quantificare il numero di occorrenze di un 
insieme di caratteri. Se ricorderete, a parte 
\w, all'inizio dell'articolo, ho utilizzato anche 
il simbolo *. Tale simbolo significa zero o più 
occorrenze di ciò che lo precede. La tabella 2 
illustra i diversi quantificatori ed il loro signi- 
ficato. 

Facciamo un esempio. Supponiamo che in 
una stringa siano contenuti dei numeri di 
telefono preceduti dal prefisso e di voler 
estrarre solo i numeri di Milano, in altre paro- 
le quelli che hanno 02 come prefisso. Ecco il 
codice che fa al caso nostro: 

var str = "Il mio numero è 02-123456789, 
mentre il numero di Tizio è 06-12309876. 
Il mio amico Caio invece ha il numero 
02-987654321. Notare 
che se 02- non è seguito da almeno una cifra, 
come in questo caso, non verrà considerato"; 
var regex = new RegExp("02-\\d + ", "gi"); 
var results = str.match(regex); 
alert(results.toString()); 

Voglio far notare la differenza tra {n} e {n,} 
come quantificatori. Se, ad esempio, avessi- 
mo usato: 



var results = str.match(regex); 



alert(results.toString()); 

se vi aspettate che il risultato sia un array 
contenente due elementi costituiti da 
"Questa è una frase." e "Questa è un'altra 
frase." allora vi sbagliate. Il risultato è un 
array costituito dall'unico elemento "Questa 
è una frase. Questa è un'altra frase." Provate 
invece a sostituire la regex vista con la 
seguente: 

var regex = new RegExp("Questa. + ?\\." "g"); 

È quasi uguale alla precedente se non per il 
fatto di avere il simbolo ? che segue +. Se pro- 
vate a lanciare lo script ora noterete che fun- 
ziona come vi aspettavate. Perché? La rispo- 
sta risiede nel concetto di quantificatori 
greedy, reluctant e possessive. 



8UAIXITIFICATORI 
REEDY, RELUCTANT 



I quantificatori visti fino a questo momento 
sono di tipo greedy (ingordi). Un quantifica- 
tore "ingordo" inizia a cercare un match sul- 
l'intera stringa. Se lo trova ha terminato altri- 
menti inizia a togliere un carattere alla volta, 
comportandosi così da ingordo! Detto in altre 
parole, un quantificatore greedy cerca di tro- 
vare un match utilizzando il maggior numero 
di caratteri possibili. Nell'esempio preceden- 
te, infatti, avendo la regex: 




var regex = new RegExp("02-\\d{5}", "gi"); 

il risultato sarebbe stato 02-12345 e 02-98765. 
Questo perché quella regex significa: "Trova 
le occorrenze che iniziano con 02, seguito dal 
segno - e poi da 5 cifre. Vale a dire, trovate le 
5 cifre non continuare a cercare perché a me 
interessano solo quelle". Se invece usassimo: 

var regex = new RegExp("02-\\d{5,}", "gi"); 

il risultato sarebbe 02-123456789 e 02- 
987654321. Questo perché la regex significa: 
"Trova le occorrenze che iniziano con 02, 
seguito dal segno - e poi da almeno 5 cifre. 
Cioè, se trovi 5 cifre non ti fermare, ma va 
avanti finché continui a trovare numeri". 
Guardate ora il seguente codice: 

var str = "Questa è una frase. Questa è un'altra 

frase."; 
var regex = new RegExp("Questa.+\\.", "g"); 



var regex = new RegExp("Questa.+\\." "g"); 

e la stringa: 

var str = "Questa è una frase. Questa è un'altra 

frase."; 

il match trovato era: "Questa è una frase. 
Questa è un'altra frase.". Questo perché + è 
greedy e trova, nell'intera stringa, il match 
desiderato. Infatti l'intera stringa inizia per 



Quantificatore 


Descrizione 


* 


Zero o più occorrenze 


+ 


Una o più occorrenze 


7 


Zero o un'occorrenza 


{n} 


Esattamente n occorrenze 


{n.} 


Minino n occorrenze 


{n,m} 


Minimo n e massimo m occorrenze 




^Tabella 2: Quantificatori * 
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"Questa", è seguita da uno o più caratteri e ter- 
mina con un punto. 

I quantificatori di tipo reluctant (riluttanti) si 
comportano in modo opposto. Sono, come 
dire, più "educati". Infatti, cercano di trovare 
un match col minor numero di caratteri pos- 
sibili. In pratica, un quantificatore reluctant 
inizia col primo carattere e ne aggiunge uno 
per volta finché trova un match. Infatti, nel 
nostro esempio: 

var regex = new RegExp("Questa. + ?\\.", "g"); 
var str = "Questa è una frase. Questa è un'altra 

frase."; 

vengono trovati due match grazie all'uso del 
quantificatore +? che, come detto, è reluctant. 
Un quantificatore di tipo possessive (possessivo) 
controlla se l'intera stringa "matcha" con il pat- 
tern dato. Se non trova il match non fa ulteriori 
controlli. Per indicare che un quantificatore è 
possessive basta farlo seguire dal simbolo +. Non 
entreremo nel dettaglio dei quantificatori pos- 
sessive dato che non sono molto supportati dagli 
attuali browser. Inoltre, simulare un quantifica- 
tore possessive utilizzando il greedy non è molto 
difficile. In tabella 3 sono illustrati i tre tipi di 
quantificatori. Potete tranquillamente consultar- 
la per realizzare le combinazioni che caso per 
caso risolvono il vostro problema 



Greedy 


Reluctant 


Possessive 


Descrizione 


* 


*? 


*+ 


Zero o più occorrenze 


+ 


+? 


++ 


Una o più occorrenze 


7 


77 


?+ 


Zero o un'occorrenza 


{n} 


{n}? 


{n}+ 


Esattamente n occorrenze 


{n,} 


{n f }? 


{n,}+ 


Minino n occorrenze 


{n,m} 


{n,m}? 


{n,m}+ 


Minimo n e massimo m 
occorrenze 


Tabella 3: Tipi Ci quantificatori 




INTASSI PERL-LIKE 



Perl è stato, probabilmente, il 
primo linguaggio di 
programmazione ad 
implementare le espressioni 
regolari. JavaScript introdusse 
il supporto alle regex ancor 
prima di Java, il quale le 
introdusse dalla versione 1.4. 
Dato che JavaScript si basò sul 
linguaggio Perl per 
l'implementazione delle regex, 
ne mantenne anche la sintassi. 
È, infatti, possibile esprimere 



un'espressione regolare in 
modo letterale utilizzando la 
sintassi: /02-\d{5}/g. Ecco un 
esempio: 



var regex = /02-\d{5}/g; 

var results = str. match (regex); 

Da notare che, usando la 
sintassi PerMike, non vi è la 
necessità dell'escape per le 
classi predefinite. 



I GRUPPI 

Arrivati a questo punto sorge un problemino. 
Supponiamo vi venga in mente di scrivere 
un'espressione regolare che, data una pagina 
HTML, estragga il contenuto dell'attributo src 
di tutti i tag img. In altre parole, gli URL di 
tutte le immagini presenti nella pagina. 
Con le conoscenze acquisite fino a questo 
momento già potete ottenere questo risultato. 
Infatti, potete scrivere una regex per estrarre 
tutti i tag img e poi un'altra che su ogni tag 
estratto trovi il contenuto di src. Vedremo, in 
ogni modo, che le espressioni regolari ci ven- 
gono incontro e ci permettono di fare lo stes- 
so lavoro con una singola regex. Il concetto 
dietro il quale si cela questa "magia" risponde 
al nome di raggruppamento. È infatti possibi- 
le dividere una regex in vari gruppi. Un grup- 
po è racchiuso all'interno delle parentesi 
tonde. Il gruppo corrisponde all'intera 
regex, il gruppo 1 alla prima coppia di paren- 
tesi tonde, il 2 alla seconda e così via. 
Scriviamo subito l'esempio che, da una pagi- 
na HTML estrae gli URL delle immagini pre- 
senti in essa. 

var str = "<html><head></head><body><img 

src='./images/testl.jpg' /> 

<!— Altro codice HTML — -> 

<img src='./images/test2.jpg' 

/></bodyx/html>"; 

var regex = new 

RegExp("<\\s*img.*?src\\s*=\\s*(\T)(- + ?)\U-*? 

>", "gj"); 

var ret = []; 

for(var results = regex. exec(str); results != nuli; 
results = regex. exec(str)) 



ret.push(results[2]); 



> 



alert(ret.toStringQ); 



Lanciando questo script noterete che saranno 
visualizzati i due URL relativi, in altre parole 
"./images/testl.jpg" e "./images/test2.jpg". 
Ricordo che il metodo exec della classe 
RegExp estrae i risultati mettendo l'intero 
match, cioè il primo gruppo (rappresentato 
dall'intera regex), all'indice e i vari gruppi 
negli indici successivi. Il gruppo che interessa 
a noi è il terzo, ossia (.+?). Notare l'uso del 
simbolo pipe, |, all'interno di (\"|'). In pratica 
svolge la funzione di un OR. Significa: "Vanno 
bene sia i doppi sia il singolo apice". 
Osservare, inoltre, l'uso dei quantificatori di 
tipo reluctant. 

Per imparare bene le espressioni regolari 
bisogna sperimentare e sperimentare e...OK 
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avete capito. Provate, ad esempio, ad utilizza- 
re quantificatori di tipo greedy nel medesimo 
codice e osservate i risultati. 
Osservando l'espressione regolare preceden- 
te, emerge Fuso di qualcosa che non avevamo 
visto prima, ovvero il codice \1. Questa tecni- 
ca è chiamata "backreferencing". In pratica, 
essa permette di riferirsi ad una stringa che è 
stata "catturata" in qualche gruppo preceden- 
te. Nel nostro caso \1 significa: "Quello che 
hai trovato utilizzando il gruppo 1, ossia 
(\"|')". In altre parole, se ha trovato un doppio 
apice allora \ 1 significa doppio apice, mentre 
se ha trovato un singolo apice \1 sarà sostitui- 
to con un singolo apice. Troverete la tecnica di 
backreferencing molto utile in svariate situa- 
zioni. 



L'APPLICAZIONE 
DI ESEMPIO 

Come detto all'inizio del presente articolo, 
vedremo ora come scrivere un pagina Web, 
contenente una textarea e un bottone, in 
grado di estrarre tutti gli script contenuti nel 
codice HTML "incollato" nella textarea stessa. 
La figura 1 ne illustra il banale layout. Quello 
che segue è il codice della parte "core": 

//estrae tutti gli script contenuti in str 
function extractScripts(str) 

{ 

// regex da usare per estrarre gli script 

var reScript = new 

RegExp("<\\s*script.*?>(.|\\n|\\r)*? 
<\\s*/\\s*script\\s*>", "gi"); 
// estrae gli script mettendoli in un array 
var scriptArray = str.match(reScript); 
// costrisce la stringa da visualizzare 
var html = buildString(scriptArray); 
// la visualizza 
display(html); 



prima costruisce la stringa che rappresenta gli 
script estratti. La seconda la visualizza. 
Da notare che, anche se lo script è in un file 
esterno, la nostra applicazioncina ci visualiz- 
za il percorso a cui punta. Se volessimo vede- 
re il sorgente del file ci basterebbe puntare il 
nostro browser a quel percorso. 



CONCLUSIONI 

Le espressioni regolari sono molto potenti. La 
cosa più importante da capire, comunque, è 
che i concetti esposti in quest'articolo sono 
applicabili a qualsiasi linguaggio di program- 
mazione che supporta le regex. Infatti, con- 
cetti quali: metacaratteri, classi, quantificato- 
ri greedy, reluctant e possessive, gruppi e 
backreference sono completamente generali 
e, apportando le opportune modifiche, potete 
utilizzare questi strumenti in ogni linguaggio 
"regex- compliant". 

Vi è da dire tuttavia, che ci sono interi libri 
dedicati alle espressioni regolari e, ovviamen- 
te, in quest'articolo non abbiamo potuto 
coprire tutti i concetti ad esse relativi. Gli 
strumenti analizzati, in ogni modo, sono 
quelli di maggiore utilizzo e vi permetteranno 
di risolvere la stragrande maggioranza dei 
problemi. Un'ultima nota: nell'esempio che 
tratta l'estrazione delle immagini non ho 
tenuto conto della possibilità che il tag img si 
estenda su più righe, come invece ho fatto per 
l'estrazione degli script. Per non escludere 
questa possibilità dovrete modificare legger- 
mente la regex in questione. Ovviamente tale 
compito è lasciato per esercizio. La potenza 
delle regex si comprende appieno ad esempio 
in problemi di normalizzazione dei database. 
Grazie alla loro fkessibilità è infatti possibile 
ottenere soluzioni efficienti in tempi decisa- 
mente brevi. 

Alessandro Lacava 




L'unica cosa degna di nota è, ovviamente, l'e- 
spressione regolare usata. In particolare, 
voglio chiarire la parte (.|\\n|\\r)*?. In sostan- 
za vuol dire: "Qualsiasi carattere o un caratte- 
re di nuova linea (\n) o un ritorno a capo (\r). 
Il quantificatore indica di prendere zero o più 
occorrenze del gruppo che lo precede.". L'uso 
di \n e \r è necessario in quanto, nel caso in 
cui lo script si estenda su più righe, non ver- 
rebbero prese in considerazione dato che il 
punto (qualsiasi carattere) non contempla i 
ritorni a capo e le nuove linee. Sulle funzioni 
buildString e display non vi è molto da dire. La 




ALIDAZIONE DI E-MAIL 



Le regex sono spesso utilizzate 
in fase di validazione dei 
campi. Ad esempio, validare un 
indirizzo e-mail è molto 
semplice. A tal proposito, 
potete utilizzare la seguente 
espressione regolare: 
/ A (\w+\.?)*\w+@(\w+\.{1})+\w+$/. 
I caratteri A e $ indicano, 
rispettivamente, l'inizio e la 
fine della stringa. Il loro uso è 



necessario perché se una 
persona inserisse 
"prova@nomesito.com, ciao", 
verrebbe interpretato 
erroneamente come indirizzo 
valido. Utilizzando A e $ 
specifichiamo che le 
espressioni valide sono quelle 
che rispettano la regex e non 
sono precedute o seguite da 
altri caratteri. 
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IL BROWSER 
SUL DESKTOP 



PROGETTARE UN'INTERFACCIA È SPESSO PIÙ FACILE PER IL WEB CHE PER LE 
APPLICAZIONI STANDALONE. ALLORA PERCHÈ NON UNIRE LE DUE COSE PROGETTANDO 
SOFTWARE CHE GIRA SUL TUO COMPUTER MA HA UNA GRAFICA HTML? 




fi 




REQUISITI 



■ MIN Mlli'lill M 

HTML,CSSJavascript f 
.NET Framework e 



Visual Basic 



3 



Microsoft Visual Studio 
2005 o Microsoft Visual 
Studio Express 



00000 



Utilizzare una finestra di Internet Explorer 
all'interno di un'applicazione desktop non 
è certo una novità per i programmatori 
Visual Basic. 

Fin da Visual Basic 6, infatti era possibile disporre, 
come oggetto COM, del controllo WebBrowser, il cui 
uso era spesso quello di mostrare file HTML di help 
o pagine web come possiamo vedere in figura 1. 




Fig. 1: un controllo WebBrowser in una form VB6 

Tale controllo era anche disponibile per i program- 
matori .NET 1.0 e 1.1 attraverso il wrapper dello stes- 
so oggetto COM, l'utilizzo della finestra di Internet 
Explorer, però è rimasto sostanzialmente lo stesso. 
Il colloquio tra applicazione desktop e quanto avvie- 
ne dentro il controllo WebBrowser non era impossi- 
bile, ma certo non era impresa di poco conto. 
Con .NET 2.0 le cose sono cambiate radicalmente, 
innanzitutto abbiamo adesso nella barra degli stru- 



tì j| RichTextBox 
|ibl| TextBox 
hz-zi ToolTip 
B_~ TreeView 



j3 WebBrowser 



+ Contenitori 

+ Menu e barre degli strumenti 

+ Dati 



Fig. 2: il controllo WebBrowser nella Toolbar di VS 
2005 



menti di Visual Studio 2005 un controllo nuovo di 
zecca chiamato, appunto, WebBrowser. 
Intendiamoci, alla base c'è sempre il solito oggetto 
COM che abbiamo visto in precedenza, ma è stato 
"incapsulato" nel codice managed in maniera magi- 
strale. 

In particolare il controllo Web Browser espone alcu- 
ne proprietà veramente interessanti: 

• Proprietà ObjectForScripting - che consente di 
esporre un oggetto al codice Javascript della pagi- 
na contenuta. 

• Proprietà DocumentText- che permette di carica- 
re qualsiasi stringa HTML nella pagina 

• Proprietà Document - che espone il documento 
caricato nella finestra come oggetto 
HTMLDocument per interagire in tutti modi pos- 
sibili con il DOM sottostante. 



A COSA SERVE 
TUTTO QUESTO? 

Certo che a questo punto vi starete domandando: 
"bello, ma a me ...?". Tuttavia, se ci pensate bene, le 
implicazioni di questi che sembrano piccoli miglio- 
ramenti sono in realtà veramente importanti. 
Qual è l'attività più dispendiosa e meno produttiva 
di un programmatore di applicazioni desktop? Sono 
sicuro che anche voi risponderete: il disegno dell'in- 
terfaccia utente. 

Quante ore perdete a disegnare sulle Forms bottoni, 
input box, combobox, tabelle ecc.. Se poi dovete 
cambiare di posto a qualche elemento? Se dovete 
eliminare un bottone che magari è referenziato in 
venti posti diversi del codice? 
Non parliamo poi di quelli che vogliono fare i "raffi- 
nati" e magari vorrebbero che in una textbox com- 
parisse un link o che in una cella di tabella ci venis- 
se un bel combobox ecc. . . Per loro comincia la "via 
crucis" dei controlli personalizzati che, spesso, risul- 
ta più dispendiosa, in termini di tempo perché 
magari il denaro è sempre lo stesso, dello sviluppo 



► 64 /Gennaio 2007 



http://www.ioprogrammo.it 



064-069 28-11-2006 11:12 Pagina 65 



Applicazioni web standalone ■ T SISTEMA 



dell'applicazione stessa. 

Alla fine, parliamoci chiaro, molti programmatori 
utilizzano i controlli che mette a disposizione 
mamma Microsoft o, se proprio non ne possono fare 
a meno, comprano qualche controllo prodotto da 
terze parti 

Il risultato è, spesso, un'interfaccia utente poco 
entusiamante, per niente intuitiva e spesso brutta. 
Per contro, invece, qual è la tecnologia che permette 
la massima flessibilità in campo di disegno di inter- 
facce utente: di certo l'HTML, specie da quando si è 
arricchito delle enormi possibilità offerte dai CSS e 
dal DOM manipolabile con Javascript. 
Non c'è dubbio che, come interfaccia utente, un sito 
web di medio livello sia di molti punti superiore ai 
normali programmi desktop che si vedono in circo- 
lazione. 

Permettere l'interazione tra applicazione Host e il 
controllo WebBrowser quindi ci consente di utilizza- 
re, in tutto o in parte, una perfetta GUI web-like in 
modo semplice ed efficace. 

Ma passiamo ad un esempio che ci fa subito entrare 
nel merito. 



URI PO' DI PRATICA 

Facciamo subito un esempio concreto. Ci viene 
commissionata un'applicazione che effettua una 
ricerca in un database SQL server, mostra i dati in 
una tabella con paginazione e consente l'esporta- 
zione dei dati in Excel. 

Decidiamo che l'interfaccia utente sia tutta web- 
like. Quindi la logica di business risiederà nella 
nostra applicazione desktop, mentre il front- end 
sarà tutto HTML. 

Per prima cosa avviamo un nuovo progetto 
Windows Application in Visual Studio 2005 (va bene 
anche Visual Studio Express). 
Abbiamo deciso di gestire tutta l'interfaccia da 
HTML, quindi inseriamo una nuova Form senza 
barra del titolo (tipo splash screen per intenderci), 
inseriamo quindi due controlli Web: il primo, anco- 
rato al top della form, verrà utilizzato come barra del 
titolo alternativa, l'altro, che riempie lo spazio rima- 



Head. htm WebHead.vb frmMain.vb frmMain.vb [Progettazione] Pagina iniziale 



WebBrowser control : Head 



WebBRowser conirol:Main 



nente, invece servirà ad ospitare tutta la GUI, come 
possiamo vedere in figura 3. 
Prima di procedere oltre dobbiamo però ancora 
effettuare un'operazione importante: nelle pro- 
prietà del progetto, nella scheda "Applicazione" (la 
prima) clicchiamo sul bottone "informazioni 
assembly", nella finestra che apparirà selezioniamo 
quindi l'opzione "Rendi assembly visibile a COM" 
(vedi figura 4), questo ci consentirà di interagire da 
codice con i controlli appena creati. 




Fig. 3: i controlli WebBrowser sulla Form 



Fig. 4: opzioni del progetto 



LA BARRA DEL TITOLO 
PERSONALIZZATA 

Lavoriamo adesso sul primo WebBrowser Control, 
che abbiamo chiamato Head, che servirà a rappre- 
sentare un control box personalizzato per la nostra 
applicazione, con i bottoni per minimizzare la fine- 
stra, ingrandirla e chiuderla. 
In questa fase non ci cureremo della grafica, ma ci 
concentreremo sulle funzionalità. 
Quindi, per prima cosa, creiamo una classe che 
espone al codice Javascript del documento caricato 
nel WebBrowser Control le funzioni di base per 
gestire le operazioni con la finestra. Creiamo tale 
classe aggiungendo al progetto il seguente codice: 

<Microsoft.VisualBasic.ComClass()> _ 
Public Class WebHead 
Dim ParentForm As Form 
Public Sub New(ByVal parentForm As Form) 

Me. ParentForm = parentForm 
End Sub 
Public Sub Minimize() 

Me. ParentForm. WindowState = 

FormWindowState.Minimized 
End Sub 
Public Sub Maximize() 

Me. ParentForm. WindowState = 

FormWindowState.Maximized 
End Sub 
Public Sub NormalO 

Me. ParentForm. WindowState = 

FormWindowState.Normal 
End Sub 




Una libreria offerta 
dalla Apple, QuickTime 
for Java, può essere 
usata per convertire 
file audio-video, 
adattandoli allo 
standard riconosciuto 
dal IPOD. 

http://developer.apple.co 
m/quicktime/qtjava/ 
http://www.onjava.eom/p 
ub/a/onjava/2003/05/1 4/q 
tj reintro.html 
http://www- 

1 28.ibm.com/developerw 
orks/wireless/library/wi- 
mvideo/?ca=dgr- 
Inxwl 7CreatelPODvideo 
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Public Sub CloseQ 



Me.ParentForm.Close() 



End Sub 



Public Function WindowState() As String 
Return 

Me.ParentForm.WindowState.ToString.ToLower 
End Function 
End Class 



End Property 



Private Sub frmMain_Load(ByVal sender As 

System. Object, ByVal e As System. EventArgs) Handles 



MyBase.Load 



Me.Head.Navigate(IO.Path.GetFullPath("Head.htm")) 

Me.Head.ObjectForScripting = HeadScriptingObject 
End Sub 
End Class 



Sul contenuto c'è poco da commentare, si tratta 
delle comuni funzioni di gestione di una Windows 
Form (che viene passata come argomento del 
costruttore New), da notare l'attributo 
Microsoft. VisualBasic.ComClassO che sta ad indica- 
re che questa è una classe esposta a COM (e quindi 
anche al controllo WebBrowser). 
Creiamo quindi il documento HTML Head.htm che 
andrà a popolare il WebBrowser Control aggiungen- 
dolo al progetto. È importante selezionare l'opzione 
"Copia" nelle proprietà del file alla voce "Copia nella 
directory di output" (figura 5), in tal modo in fase di 
compilazione anche i file HTML verranno copiati 
nella directory del programma. 




H Origini dati |G3^ Visualizza... |^J Visualizza., 



I I J 



Nume file 



| Copia sempre 
MtìdU.llUll 



Copia nella directory di output 



Fig. 5: Copia nella directory di output i file HTML 

Prima di andare ad editare il file HTML però dobbia- 
mo fare ancora una cosa nel codice della Window 
Form: dobbiamo instanziare un oggetto di tipo 
WebHead (la classe che abbiamo creato in prece- 
denza) e definirlo come oggetto accessibile allo 
scripting per il WebBrowser Control Head. 
Facciamo tutto questo nel codice della Form: 

Public Class frmMain 

Private JHeadScriptingObject As WebHead 

Private ReadOnly Property HeadScriptingObject() As 

WebHead 

Get 

If JHeadScriptingObject Is Nothing Then 

JHeadScriptingObject = New WebHead(Me) 
End If 

Return JHeadScriptingObject 
End Get 



In pratica abbiamo prima definito una proprietà che 
crea automaticamente un istanza di WebHead (con 
riferimento alla finestra corrente), poi abbiamo 
inserito, nell'evento Load della Form, il codice 
necessario ad aprire il file Head.htm nel controllo 
WebBrowser Head e assegnare a quest'ultimo l'i- 
stanza del tipo WebHead come oggetto di scripting. 
A questo punto l'attenzione si sposta sul file HTML, 
che praticamente fa da "Client" (mentre l'applica- 
zione fa da "Server"). L'oggetto con il quale 
Javascript può parlare con l'applicazione è win- 
dow. external che, in questo caso, sarà proprio l'og- 
getto di tipo WebHead che abbiamo assegnato al 
WebBrowser Control. 

Quindi, nel file Head.htm inseriremo una sezione 
script di questo tipo: 

<script language="javascript" type="text/ecmascript"> 
var context=window.external; 
function minimize(){ context.Minimize();} 
function maximize(){ context.Maximize();} 
function closeWindow(){ context.Close();} 
function windowState(){ return context.WindowState();} 
function normal(){ context.Normal();} 
function switchState(caller) { 
if(windowState()=="normal") { 

maximize(); 

caller.value="= =" 



else{ 

normal(); 
caller.value="[]" 



} 

</script> 

In pratica abbiamo fatto un "wrapper" client delle 
funzioni esposte dall'oggetto di tipo WebHead 
rimappando l'oggetto window. external sulla variabi- 
le context per abbreviare il codice e inserendo una 
funzione di switch per il bottone che dovrà gestire 
l'ingrandimento e il ridimensionamento della fine- 
stra. 

L'HTML vero e proprio sarà, per ora veramente 
minimo: 

<body bgcolor="Background" text="white" 

style="margin:Opx"> 
<table width="100%" cellpadding="0" cellspacing="0"> 
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<tr> 


<td>Applicazione</td> 


<td align="right"> 


<table cellpadding="0" cellspacing='T 


> 


<tr> 


<tdxinput type="button" 
onclick="minimize()" value="_' 


/></td> 


<tdxinput type="button" 
onclick="switchState(this)" value="[]' 


/></td> 


<tdxinput type="button" 
onclick="closeWindow()" value="X' 


/></td> 


</tr> 


</table> 


</td> 


</tr> 


</table> 


</body> 



WebBrowserApp Pagii ial " sbHead.vb frmMain.vb 



A questo punto siamo pronti per la prima esecuzio- 
ne, quindi premiamo il tasto F5 ottenendo la finestra 
che vediamo in figura 6. 



Fig. 6: La prima esecuzione 

Certo che il risultato non è niente di eccezionale, 
noterete però che le chiamate alle funzioni dell'ap- 
plicazione Host funzionano perfettamente. 
Lavoriamo quindi un po' sulla formattazione e gli 
stili CSS del file HTML ed otteniamo facilmente - e 
senza dover ricompilare nulla - il risultato di cui in 
figura 7. 




Fig. 7: La nostra barra del titolo migliorata 

Non ci dilunghiamo sugli stili applicati, basta dare 
un'occhiata ai sorgenti allegati al CD, c'è solo da sot- 
tolineare che tutte le risorse usate dal file HTML 
(icone,CSS,script esterni) devono essere inclusi nella 
directory del progetto e contrassegnati con l'opzio- 
ne "copia nella directory di output". 



LA CONNESSIONE 
AL DATABASE 

Prima di costruire il front- end vero e proprio dob- 
biamo predisporre la nostra logica di business, quin- 
di per prima cosa - nelle impostazioni del progetto - 
selliamo la nostra stringa di connessione in modo 
da poterla facilmente cambiare a runtime (figura 8) . 



Applicazione 
Con pila 
Debug 
Riferimenti 



bmcronizza Visi lalizza codice 



Le impostazioni dell'applicazione consentono di memorizzare e recuperare te 
impostazioni delle proprietà e altre informazioni per l'applicazione, Ad esempio, le 
preferenze di un utente relative ai colori possono essere salvate e quindi recuperate 
alla su< cessiva eseci izione dell'applicazione, 
azione.., 



(Stringa di e... _▼] 



zi 



Fig. 8: Impostazione della connessione 

Il workflow delle chiamate sarà: 

• Il codice HTML invia una richiesta con i parame- 
tri di selezione 

• L'applicazione compone la query ed estrae i dati 
in XML, processa questi dati con un foglio di stile 
XSL e rinvia la stringa HTML alla pagina web 

• Con i dati formattati la pagina web riempie un ele- 
mento DIV mostrando i risultati 

Impostiamo quindi, nel nostro progetto, la classe 
che fa da interfaccia verso il database, da un lato e 
verso il codice Javascript dall'altro. 
Come abbiamo fatto per il WebBrowser Control 
Head, anche per il WebBrowser Control Main creere- 
mo quindi un corrispondente file HTML (che chia- 
meremo Main.htm) che verrà in esso caricato. A 
questo documento HTML andrà, dal lato dell'appli- 
cazione, associato un oggetto esposto allo scripting 
che sarà rappresentato dalla classe che chiameremo 
WebMain. 



INTERPRETAZIONE QUERY 

Per prima cosa la nostra classe esporrà un metodo 
che restituisce il risultato di una query al database. 
Questo processo si compone di due fasi distinte: 

1. Estrazione dati in formato XML 

2. Trasformazione con XSL in HTML 



La funzione a ciò deputata è : 

Public Function GetCustomers(ByVal filter As String) As 

String 
'costruzione della query 

Dim sb As New System.Text.StringBuilder 
sb.Appendl_ine("select * from Customers") 
'filter è il filtro gestito dal codice script 

If Not String. IsNullOrEmpty(filter) Then 
'trasformazione del carattere jolly * nel corrispondente 

SQL % 

sb.AppendFormat("WHERE {0}", 

filter. Replacef*", "%")) 

sb.AppendLine() 
End If 

sb.AppendLine("FOR XML AUTO") 'legge in XML 
Dim conn As New 
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e- 



Per il funzionamento 

dell'esempio del 

codice allegato 

modificare 

opportunamente la 

stringa di connessione 

al database nelle 

impostazioni del 

progetto 



SqlConnection(My.Settings.ConnectionString) 

Dim cmd As New SqlCommand(sb.ToString, conn) 
'lettura dati 

Dim reader As SqlDataReader 

conn.Open() 

reader = 
cmd.ExecuteReader(CommandBehavior.CloseConnection) 



Dim queryResult As String 



While reader. Read 



queryResult &= reader.GetString(O) 



End While 



reader.CloseQ 



queryResult = String. Format("<root>{0}</root>", 

queryResult) 



Dim strReader As New 



IO.StringReader(queryResult) 



'impostazione variabili di pagina 



Me.CurrentDocXml 



New 

XPathDocument(strReader) 



Me.CurrentPage = 1 



'chiamata funzione di trasformazione XSL 



Return TransformDocQ 



End Function 

Come avrete notato il filtro viene affidato all'elabo- 
razione da parte del codice script del documento 
HTML, quest'ultimo si presenterà pressappoco così: 

function getSearchResult(){ 

var filter = []; 
// searchControIs è l'array di textBox contenenti i termini 

di ricerca 
for(var i=0;i<searchControls.length;i++){ 
var filterValue = 

searchControls[i] .value; 



if(filterValue!="") { 



//costruzione di un elemento della query basata sul 

presupposto che il textBox 
//abbia l'ID corrispondente al nome del campo 

filter[filter.length] = 
searchControls[i].id + " LIKE '" + filterValue + "' " ; 



} 



} 



//unione degli elementi della query 



currentFilter = filter.join(" AND "); 



//chiamata alla funzione GetCustomers 



var searchResult = 



window.external.GetCustomers(currentFilter); 
//utilizzo dell'HTML di ritorno per riempire una DIV 
document.getElementById("result").innerHTML = 

searchResult; 



La query XML produce un documento tipo: 



<root> 
<Customers CustomerID="ALFKI" 

CompanyName="Alfreds Futterkiste" 



ContactName= 


"Maria Anders" ContactTitle= 


="Sales 


Representative" Address="Obere Str. 57' 


City=' 


Berlin" 


PostalCode="12209" 


Country="Germany" 


Phone 


="030- 




0074321" Fax="030-0076545"/> 




</root> 



dove quindi tutti i campi della tabella diventano 
attributi e ogni riga un elemento. 
Questo risultato, come abbiamo visto nella funzione 
GetCustomers, viene processato da un'ulteriore fun- 
zione : 

Private _CurrentDocXsl As XPathDocument 
Private ReadOnly Property CurrentDocXsl() As 

XPathDocument 



Get 



If _CurrentDocXsl Is Nothing Then 



_CurrentDocXsl = New 

XPathDocument(queryResult.xsl") 



End If 



Return _CurrentDocXsl 



End Get 



End Property 



Public Function TransformDoc() As String 

Dim transform As New XsICompiledTransform 



transform.Load(CurrentDocXsl) 



Dim args As New XsltArgumentList 



args.AddParam("currentPage", 



CurrentPage) 



Dim out As New System.Text.StringBuilder 
Dim strWriter As New IO.StringWriter(out) 



transform .Transform(CurrentDocXml, args, 



strWriter) 



Return out.ToString 



End Function 

Questa funzione non fa altro che processare l'output 
XML della query con il foglio di stile XSL 
queryResult.xsl (anch'esso inserito nel progetto e 
definito come "da copiare" nella directory di output) 
di cui riportiamo un estratto: 

<?xml version="1.0" encoding="UTF-8" ?> 
<xsl:stylesheet version="1.0" 

xmlns:xsl="http://www.w3.org/1999/XSI7Transform"> 



<xsl:output method="html" encoding="utf- 



8"/> 



<xsl:param 

name="currentPage">l</xsl:param> 



<xsl:param 



name="pagesize">10</xsl:param> 



<xsl:param name="startPage" 

select="(($currentPage - 1) * $pagesize) + 
l"x/xsl:param> 
<xsl:param name="totalPages" 

select="ceiling(count(/*/Customers) div 
$pagesize)"x/xsl:param> 



<xsl:template match="/"> 
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<table cellpadding= 
cellspacing="0" 


'2" 
width="100%"> 


<thead> 


<tr> 


<th>Nome ditta</th> 


<!-- 
altri campi --> 


</tr> 


</thead> 


<tbody> 


<xsl:for-each 
select=7*/Customers[position()>=$startPage and 
position()<($startPage + $pagesize)]"> 


<tr class= 


="rowl"> 


<tdxxsl:value-of select="@CompanyName7></td> 


<!-- altri 

campi --> 


</tr> 


</xsl:for-each> 


</tbody> 


<tfoot> 


<!-- 
paginazione — > 


</table> 


</xsl:template> 


</xsl:stylesheet> 



End Sub 

La funzione viene richiamata in modo diretto da 
HTML con : 

<button 

onclick="window.external.SaveAsExcel()"> Esporta in 

excel </button> 

La funzione TransformDocExcel presente nel codice 
di SaveAsExcel processa anch'essa l'output XML 
della query in un'unica tabella. 



I RISULTATI 

Risultato del nostro lavoro sarà una maschera inizia- 
le di ricerca per quattro campi, vedi figura 9, con 
possibilità di utilizzare i caratteri jolly. 



Applicazione 




□EH 




Ricerca database clienti 










Nome contatto 




Nome azienda 


EZ Z3L 




Indirizzo 


Città 




1 1 


1 


1 












Cerca 










Fig. 9: Maschera di ricerca iniziale 



ESPORTAZIONE IN EXCEL 

Per l'esportazione in Excel potevamo utilizzare 
anche le librerie COM di excel, ma in questo caso 
nella macchina di destinazione avrebbe dovuto 
esserci Excel, abbiamo sfruttato quindi la possibilità 
che ha Excel (dalla versione 2000) di "capire" una 
tabella in formato HTML. Così la funzione nella 
classe WebMain: 

Public Sub SaveAsExcel() 
'dialogo per il nome del file 

Dim saveDialog As New SaveFileDialog 

saveDialog.InitialDirectory = 
My.Computer.FileSystem.SpecialDirectories.MyDocuments 

saveDialog. DefaultExt = ".xsl" 

saveDialog. Filter = "File excel (*.xls)|*.xls" 



saveDialog. OverwritePrompt = True 



saveDialog. AddExtension = True 



If saveDialog. ShowDialog = DialogResult.OK Then 



'scrittura nel file XLS dei dati HTML 



My. Computer. FileSystem.WriteAIIText(saveDialog.FileNam 



e, Me.TransformDocExcel, False) 



If MsgBox("Vuoi vedere il risultato?", 



MsgBoxStyle.Question Or MsgBoxStyle.YesNo, "Export 



Excel") = MsgBoxResult.Yes Then 



'apertura a richiesta di EXCEL 



System. Diagnostics.Process.Start(saveDialog.FileName) 



End If 



I risultati appariranno poi in forma di tabella (il 
risultato della trasformazione XSL), come potete 
vedere in figura 10 

Tutti gli effetti (gradienti, roll-over ecc..) sono stati 
ottenuti con CSS, HTML e un po' di Javascript. 



IhtfWIWfr 1» ***«**■ *4. 



r,^!_-.i, ,.-..h^n 



Garroni* DSMPMJÌl 

■Una fltSBtttt 
,_ CIPUH4' 

-~-,v-. n»:i.i.-uf.r 






SET i* r f-**s*-^ 



(*t)*«M (4|)MSH 



■:.---.-. ,-..-;■>". 



End If 



Fig. IO: interfaccia con i risultati 



CONCLUSIONI 

Utilizzando il controllo WebBrowser con le possibi- 
lità che offre di "dialogo" con il documento HTML 
sottostante si è ottenuta un'interfaccia gradevole e 
funzionale in una frazione del tempo che ci sarebbe 
voluto ad implementare controlli personalizzati. 
In più otteniamo l'ulteriore vantaggio che le modifi- 
che all'interfaccia saranno implementabili sempli- 
cemente cambiando il codice HTML senza dover 
ricompilare il programma. 

Francesco Smelzo 
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APPUNTAMENTI: 
GESTIAMOLI IN JAVA 

VI È MAI CAPITATO DI UTILIZZARE LA FUNZIONE CALENDARIO DI OUTLOOK? SAPEVATE 
CHE QUANDO INVITATE QUALCUNO AD UNA RIUNIONE UTILIZZATE UNO STANDARD? IN 
QUESTO ARTICOLO VEDREMO COME ACCEDERE Al CALENDARI 




^ 



REQUISITI 



Linguaggio Java 




Molti di voi utilizzano Outlook. Qualcuno 
fra voi ne avrà provato la funzione calen- 
dario. Programmo una riunione e invio 
una mail a qualcuno. Nella mail in questione è con- 
tenuto un invito che mostra esplicitamente Fora- 
no, il giorno, l'oggetto della riunione. L'utente che 
riceve la mail può accettare o meno l'invito. Molto 
probabilmente tutto questo potrebbe essere fatto 
manualmente. Ma poiché siamo nell'era dell'auto- 
mazione, esiste un formato particolare con cui pos- 
sono essere gestiti tutti gli eventi legati ad un calen- 
dario. Se avrete la pazienza di dare uno sguardo al 
contenuto testuale di una mail contenente un invi- 
to di Outlook scoprirete che al suo interno c'è qual- 
cosa del genere: 

BEGIN:VCALENDAR 

PRODID: -//Microsoft Corporation//Outlook 11.0 

MIMEDIR//EN 
VERSIONE. 
METHOD:REQUEST 
BEGIN:VEVENT 
ATTENDEE;ROLE=REQ- 

PARTICIPANT;RSVP=TRUE:MAILTO:OMISSIS 
ATTENDEE;ROLE=REQ- 

PARTICIPANT;RSVP=TRUE:MAILTO: OMISSIS 
ATTENDEE;ROLE=REQ- 

PARTICIPANT;RSVP=TRUE:MAILTO: OMISSIS 
ATTENDEE;ROLE=REQ- 

PARTICIPANT;RSVP=TRUE:MAILTO: OMISSIS 
ORGANIZER:MAILTO:Omissis 
DTSTART: 20061 109T140000Z 
DTEND:20061109T143000Z 



Vienna. \nLuogo: 



LOCATION: Ufficio del capo 



TRANSP:OPAQUE 



SEQUENCE:0 



UID:040000008200E00074C5B7101A82E0080000000 

00066AB1D5B02C7010000000000000000100 

0000016E7B65839431F4E90F513D9BFDCB856 



DTSTAMP:20061107T095436Z 



DESCRIPTION:Data: giovedì 9 novembre 2006 15.00- 

15.30 (GMT + 1.00 h) 

Amsterdam \, Berlino\, Berna\, Roma\, Stoccolma\, 



gianmarco\n\n*~*~*~*~*~*'> 



*\n\n\n 



SUMMARY: Programmazione budget annuale 



PRIORITY:5 



X-MICROSOFT-CDO-IMPORTANCE: 1 



CLASS: PUBLIC 



BEGIN:VALARM 



TRIGGER:-PT15M 



ACTION: DISPLAY 



DESCRIPTION : Reminder 



END:VALARM 



END:VEVENT 



END:VCALENDAR 

Quando Outlook riceve questa roba, la interpreta e 
la mostra all'utente in un formato comprensibile. 
In realtà il formato dei calendari è un formato stan- 
dard, condiviso da una marea di applicazioni inclu- 
so Outlook. Questo stesso invito potrebbe essere 
letto anche da iCal di Mac, proprio perché il forma- 
to è uno standard. Nella realtà non è proprio tutto 
così semplice, perché qualcuno si ostina a voler 
modificare gli standard, ma in linea di massima il 
concetto appare chiaro. In questo articolo ci occu- 
peremo appunto dello standard che sottende alla 
gestione dei calendari. 



INTRODUZIONE 
A ICALENDAR 

La definizione dello standard è contenuta 
nell'RFC 2445. Il formato è molto semplice. Non 
solo. È anche disponibile una libreria Java per 
manipolarlo, iCal4j ( http://ical4j.sourceforge.net /). 
Questa offre sia un parse sia un modello a ogget- 
ti che permette di modificare dati iCalendar esi- 
stenti o di crearne di nuovi. È implementata 
anche la validazione in modo da assicurarsi che i 
dati contenuti siano consistenti con la specifica. 
Il parser è la componente software che si occupa 
di elaborare i dati iCalendar e di tradurli in una 
rappresentazione interna basata sugli oggetti. La 
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struttura di questi oggetti invece è il modello a 
oggetti. Un semplice esempio di dati iCalendar è 
il seguente: 



BEGIN:VCALENDAR 



CALSCALE : GREGORIAN 



X-WR-TIMEZONE;VALUE=TEXT: US/Pacific 



METHOD:PUBLISH 



PRODID: -//Apple Computer^ Inc//iCal 1.0//EN 
X-WR-CALNAME;VALUE=TEXT:Example 
VERSIONE. 
BEGIN:VEVENT 



SEQUENCE:5 



DTSTART;TZID=US/Pacific:20021028T140000 



DTSTAMP:20021028T011706Z 



SUMMARY:Coffee with Jason 



UID:EC9439Bl-FF65-llD6-9973-003065F99D04 
DTEND;TZID = US/Pacific:20021028T150000 



BEGIN:VALARM 



TRIGGER;VALUE=DURATION:-PlD 



ACTION: DISPLAY 



DESCRIPTION:Event reminder 



END:VALARM 



END:VEVENT 



END:VCALENDAR 

Ciascuna linea di testo è chiamata linea contenu- 
to e consiste in due elementi separati da un 
carattere di due punti (:).La prima parte è chia- 
mata proprietà mentre il valore è la seconda 
parte. Per esempio, la riga VERSIONE. contiene 
la proprietà VERSION che vale 2.0. La proprietà 
può essere combinata con uno o più parametri, 
da cui è separata da punti e virgola (;). Ciascun 
parametro è separato da una virgola (,). Per 
esempio, la proprietà TRIGGER possiede il para- 
metro VALUE che vale DURATION. Si noti che, 
per specifica, le linee terminano con il separato- 
re CRLF. 



CREARE 

UHI CALENDARIO 

Vediamo ora come utilizzare la libreria iCal4j per 
creare un nuovo calendario. I passaggi necessari 
non sono complessi e possono essere riassunti 
nei punti seguenti: 

• creazione di un oggetto Calendar che rappre- 
senta l'intero calendario. Questo verrà arric- 
chito di eventi e di proprietà. 

• Impostazione delle proprietà di base, come la 
versione del file e la tipologia di calendario. 

• Aggiunta degli eventi e elementi to-do che rap- 
presentano il contenuto di questo calendario 



ed eventuali configurazioni delle proprietà 
relative a ciascun evento. 

• Produzione in output del file di calendario, su 
un qualsiasi stream di output, come per esem- 
pio un file su disco. 

Vediamo ora come si traduce in codice questa 
sequenza di eventi realizzando un semplice pro- 
gramma che produce in output il file 
calendario. test con un solo evento, la cui descrizio- 
ne è "Evento di prova" e impostato per l'istante cor- 
rente. Per inizializzare il calendario si fa come 
segue: 

Calendar calendar = new Calendari); 
calendar.getProperties().add(new ProdId("-//Ben 

Fortuna//iCal4j 1.0//EN")); 

calendar.getProperties().add(Version.VERSION_2_0); 
calendar.getProperties().add(CalScale. GREGORIAN); 

L'evento viene creato in questo modo, utilizzan- 
do l'oggetto Date definito nel package net.fortu- 
na.ical4j.model. Questo viene inizializzato con 
la data corrente, utilizzando il costruttore di 
default dell'oggetto java.util.Date: 



VEvent ev = 


new VEvent(new 
net. fortuna. ical4j. model. Date(new 


DateQ), 


"Evento di prova"); 



Viene poi ottenuto l'elenco delle proprietà. Viene 
estratta la DTSTART che viene impostata al tipo 
Value.DATE. Questo è necessario per fare in 
modo che l'evento sia definito come "evento 
tutto il giorno": 



PropertyList pi = ev.getPropertiesQ; 



pi. getProperty(Property. DTSTART). getParameters(). ad 

d(Value.DATE); 

L'evento viene poi aggiunto al calendario con 
questa chiamata: 

calendar.getComponents().add(ev); 

La fase finale è quella che comporta la scrittura 
del calendario su un file. Per fare questo viene 
utilizzato un oggetto FileOutputStream per pun- 
tare al file fisico da creare. Per serializzare il 
calendario viene utilizzata la classe 
CalendarOutputter: 

FileOutputStream fout = new 

FileOutputStream("calendario.test"); 
CalendarOutputter outputter = new 

CalendarOutputterQ; 




Il Wiki di iCal4j 
(http://wiki.modularity.ne 
t.au/ica!4j/ ) offre una 
serie di informazioni 
per iniziare a lavorare 
con la libreria, anche 
se non è ancora molto 
completo. Forse il 
lettore vorrà 
contribuire? 
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Per sperimentare con i 

calendari in formato 

iCalendar è possibile 

utilizzare un 

programma 

multipiattaforma e 

Open Source come 

Mozilla Sunbird 

( http://ftp.mozilla.org/pu 

b/mozilla.org/calendar/su 

nbird/ ). È ancora in 

versione alfa, ma 

disponibile per 

Windows, Linux e 

Macintosh. 



try { 




outputter.output(calendar, 


fout); 


} catch (ValidationException e) { 




throw new IOException( e 


.getMessage() ); 


} 



//appuntamento alle 9.30 



La classe CalendarOutputter dispone di due 
metodi output(). Il primo si aspetta un oggetto 
OutputStream, mentre il secondo un oggetto 
Writer. Questo permette di scrivere indifferente- 
mente su un file binario (OutputStream) o di 
testo (Writer). Un altro aspetto interessante 
riguarda la possibilità di attivare la validazione 
dei dati che vengono scritti sul file. Questo si 
ottiene semplicemente passando il flag valida- 
ting a true in fase di costruzione dell'oggetto. 



ALTRE TIPOLOGIE 
DI EVENTI 

Nell'esempio precedente abbiamo visto come 
creare un evento che dura tutto il giorno. In Figura 
2 un evento di questo tipo è quello che riporta la 
descrizione "corso intensivo di nuoto" e viene rap- 
presentato in modo diverso rispetto agli eventi che 
hanno una durata definita in termini di ore e minu- 
ti. Con iCalendar e iCal4j è possibile definire anche 
eventi di questo tipo. Nel codice che segue viene 
utilizzata la classe Calendar del package java.util. 
Questa è una classe della piattaforma Java che si 
occupa di gestire date e orari espressi all'interno di 
un calendario. Calendar è una classe astratta, ma è 
presente la classe concreta GregorianCalendar che 
implementa il calendario gregoriano. Il metodo 
getlnstanceO ritorna una istanza di calendario 
dove il giorno corrente "punta" al giorno odierno. 
Questa classe dispone poi di due metodi per cam- 
biare il giorno corrente. Il metodo add() aggiunge 
una quantità a una delle numerose proprietà gesti- 
te dalla classe. Nel codice vengono aggiunti 7 gior- 
ni. Esiste una proprietà per ciascun elemento del 
datario (giorno, mese, anno, ora, minuti, secondi). 
In questo caso è stata utilizzata la costante 
DAY_OF_MONTH, che indica il giorno del mese. 
L'altro metodo offerto dalla classe Calendar per 
modificare la data corrente è set(). Questo imposta 
la proprietà a un valore arbitrario. Nell'esempio di 
codice viene impostata l'ora 9:30. Si noti la diffe- 
renza tra add() e set(). Nel primo caso si aggiunge, 
anche valori negativi, al datario attuale. Nel secon- 
do caso si imposta un valore arbitrario. 
Il codice è il seguente: 



java.util. Calendar cai 



java.util.Calendar.getlnstanceO; 



cal.set(java.util.Calendar.HOUR_OF_DAY, 9); 

cal.setQava.util.Calendar.MINUTE, 30); 

VEvent meeting = new VEvent(cal.getTime(), 1000 * 
60 * 60, "Riunione di lavoro"); 



L'ora elaborata con la classe Calendar viene passa- 
ta poi al costruttore dell'oggetto VEvent, a cui viene 
indicata anche la descrizione "Riunione di lavoro" 
e la durata dell'evento. In questo caso è un'ora (60 
secondi * 60 minuti * 1000 millisecondi). 
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Fig. 1: Un'applicazione d'esempio su sourceforcie 



ALTRI ELEMENTI 
DI CALENDARIO 

Fino a ora abbiamo visto come aggiungere even- 
ti al calendario, siano essi di durata definita o 
relativi a tutto il giorno. In un calendario è anche 
possibile inserire allarmi, indicazioni di quando 
una persona è occupata o libera o elenchi di atti- 
vità da svolgere. L'ultima di queste tipologie è di 
facile realizzazione, in quanto il codice da imple- 
mentare è sostanzialmente uguale a quello di 
creazione di un evento. Cambia solo il nome 
della classe da utilizzare. Per creare l'attività 
"Riunione di lavoro" della durata di un'ora è 
necessario quindi utilizzare il seguente codice: 



java.util. Calendar cai 



java.util.Calendar.getlnstanceQ; 



//sposta il calendario alla settimana prossima 
cal.add(java.util.Calendar.DAY_OF_MONTH, 7); 



//appuntamento alle 9.30 



//sposta il calendario alla settimana prossima 
cal.add(java.util.Calendar.DAY_OF_MONTH, 7); 



cal.set(java.util.Calendar.HOUR_OF_DAY, 9); 

cal.setQava.util.Calendar.MINUTE, 30); 

VToDo meeting = new VToDo(cal.getTime(), 1000 
60 * 60, "Riunione di lavoro"); 



Anche gli allarmi sono di facile creazione. Questa 
tipologia di eventi viene spesso utilizzata dal pro- 
gramma client per avvisare l'utente che c'è un'e- 
vento che inizia tra poco. Chi utilizza un qualche 
programma di calendario sarà abituato a questo 
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tipo di avvisi, spesso molto invadenti e insistenti! 
Per creare un allarme che deve essere presentato 
un'ora prima rispetto a un evento si può scrivere: 

VAIarm reminder = new VAIarm(-1000 * 60 * 60); 

Poi si può impostare la frequenza e il numero di 
avvisi. Nel codice seguente vengono impostate 
tre ripetizioni, una ogni 15 minuti. Questo vuol 
dire che il primo avviso verrà presentato un'ora 
prima, poi il successivo dopo un quarto d'ora e il 
terzo dopo ancora quindici minuti: 

reminder.getProperties().add(new Repeat(3)); 
reminder.getProperties().add(new Duration(1000 * 60 

* 15)); 

Le proprietà dell'allarme possono anche memoriz- 
zare l'azione da intraprendere. Per esempio è pos- 
sibile visualizzare un messaggio di avviso 
(DISPLAY). Le altre possibilità sono AUDIO, EMAIL 
e PROCEDURE. Queste sono definite, come il resto 
degli elementi presentati in precedenza, nel 
modello a oggetti di iCal4j che non fa altro che 
riportare nel mondo lava quanto espresso nelle 
specifiche di iCalendar: 

reminder.getProperties().add(Action. DISPLAY); 
reminder.getProperties().add(new 

Description("Riunione alle ore 9:30")) 

Ovviamente la gestione degli allarmi è totalmen- 
te a carico dell'applicazione che elabora il file di 
dati iCalendar. È infatti compito suo, nel 
momento definito nell'allarme, operare l'inter- 
vento relativo all'azione indicata. Nel nostro 
esempio, l'azione è la visualizzazione del mes- 
saggio di avviso "Riunione alle ore 9:30". Si noti 
che l'allarme, utilizzando l'azione PROCEDURE, 
offre interessanti possibilità di sviluppo. iCal di 
Apple, per esempio, consente di impostare allar- 
mi legati a eventi che aprano in automatico un 
documento, con un anticipo prefissato. Per 
esempio, si può impostare iCal in modo che 
quindici minuti prima dell'inizio dell'evento 
"Riunione di lavoro" aprano il file Word "agen- 
da_riunione.doc" in modo che l'utente lo possa 
consultare o stampare. Un'altra possibilità è 
quella legata all'invio di messaggi di posta. Si 
ipotizzi di avere impostato un evento "Consegna 
articolo iCalendar per ioProgrammo". Sarebbe 
utile che un certo lasso di tempo prima della sca- 
denza venga aperto un nuovo messaggio di posta 
pronto per l'invio del materiale. Questi sono solo 
alcuni esempi di come sia possibile sfruttare le 
potenzialità offerte da iCalendar. 
L'ultimo elemento che analizziamo è rappresen- 
tato dalla classe VFreeBusy, che permette di defi- 



nire i momenti in cui una persona è libera o 
occupata. Semplicemente, il costruttore di que- 
sta classe si aspetta due parametri: l'inizo e la 
fine del periodo "occupato". Per esempio, si ipo- 
tizzi che una persona sia in ferie da oggi per un 
mese. In questo caso si può scrivere come segue: 

java.util.Calendar cai = 

java.util.Calendar.getlnstanceO; 
Date inizio = cal.getTime(); 

cal.add(java.util.Calendar.WEEK_OF_YEAR, 4); 

Date fine = cal.getTime(); 

VFreeBusy request = new VFreeBusy(inizio, fine); 
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Fig. 2: Ical in esecuzione su Mac OS X 



CONCLUSIONI 

Implementare il supporto allo standard 
iCalendar nelle proprie applicazioni Java è 
molto semplice grazie alla libreria iCal4j. Oltre 
che semplice, è anche molto utile, in quanto la 
vostra applicazione sarà in grado di comunica- 
re con un ampio raggio di utenti, siano essi uti- 
lizzatori di Windows, Linux o Mac OS X e indi- 
pendentemente dal software utilizzato. 
Pensate al potenziale sviluppo della vostra 
applicazione gestionale. Potreste legare un 
evento a ogni progetto e pubblicare il calenda- 
rio su un server web. Gli utenti che lo sottoscri- 
vessero avrebbero sempre sotto controllo Fini- 
zio e la fine prevista delle attività. Potreste pre- 
sentare allarmi direttamente all'utente, utiliz- 
zando il loro programma di calendario. 
Un'altra possibilità è gestire l'elenco delle atti- 
vità da svolgere. Quando l'utente le completa 
potrebbe indicarlo all'applicazione che si occu- 
perebbe di rimuovere l'attività dall'elenco. 

Massimiliano Bigatti 



Se siete 

programmatori a 
basso livello o avete 
voglia di conoscere di 
più le specifiche di 
iCalendar potete 
consultare 
direttamente la 
RFC2445, disponibile 
all'indirizzo 
http://www. ietf.org/rf c/rf 
c2445.txt. 
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FACCIAMO LEGGERE 
IPDFALL'IPOD 

IN QUESTO ARTICOLO CERCHEREMO DI UTILIZZARE JAVA E UNA FAMOSA LIBRERIA 
PER AUMENTARE LE POTENZIALITÀ DEL NOSTRO IPOD, TRASFORMANDO I FILE PDF 
IN DOCUMENTI LEGGIBILI SUL NOSTRO LETTORE MULTIMEDIALE 




Q CD U WEB 

L'IP0D_parla_Java.zip 



fa* 



^ 



REQUISITI 



- t J2SE 
\ J2SE. JPedal 

00000 



LJ iPod è uno dei più famosi lettori mp3/mp4 
dei nostri tempi, status symbol per molti, 
i fedele compagno per altri. Su questo disposi- 
tivo è possibile ascoltare mp3, leggere note e vedere 
video. In rete è facile trovare programmi che con- 
sentono di convertire audio e video per questo 
dispositivo, ma un "geek" che si rispetti deve sempre 
fare qualcosa in più con il suo iPod. Perciò utilizze- 
remo il fedele Java e una manciata di librerie 
OpenSource per fare qualcosa che ci consenta di 
caratterizzare il nostro lettore come piace a noi. . . 



L'APPLICAZIONE 

Prima di tutto mettiamoci nell'ordine di idee che 
FIPOD dispone di uno schermo da 2,5 pollici e una 
risoluzione di 320x240. Su questo schermo si posso- 
no visualizzare foto, video e testo. Il nostro scopo è 
riuscire a leggere sullo schermo dell'iPod dei file 
PDF. Poiché non abbiamo nessuna intenzione di 
scrivere da zero un visualizzatore di PDF, utilizzere- 
mo un convertitore che ci consente di trasformare il 
formato PDF in qualcosa di visualizzabile sull'iPod. 
In particolare realizzeremo un programma che ci 
consente di: 

• Convertire un PDF in testo semplice, che può 
facilmente essere letto come "nota" 

• Trasformare un file PDF in una serie di immagini 
per poterlo leggere comodamente con il visualiz- 
zatore di immagini. 

Per prima cosa, la nostra applicazione, che chiame- 
remo IpodConverter, dovrà essere dotata di un'in- 
terfaccia grafica che mostri le diverse opzioni. 



INTERFACCIA GRAFICA 

L'utente deve poter scegliere tra 2 diverse opzioni. 
Iniziamo quindi scrivendo le porzioni di codice per 
un semplice Frame con 2 bottoni. L'applicazione è 



molto semplice, tuttavia vogliamo rimanere un po' 
nello stile IPOD, quindi utilizzeremo qualcosa per 
abbellire la nostra interfaccia. Inizialmente creere- 
mo un semplice JFrame e aggiungeremo 2 JButton. 
A questi bottoni assoceremo degli ActionListener. 
Dovremo poi sviluppare le 2 funzionalità associate 
ai diversi bottoni 

jButtonl.setText("PDF to image"); 
JButton 1 .addActionListener(new 

java.awt.event.ActionListener() { 
public void 
actionPerformedQ'ava.awt.event.ActionEvent evt) { 
action l(evt); 
} 



}); 



jButton2.setText("PDF to text"); 



jButton2.addActionListener(new 

java.awt.event.ActionListener() { 
public void 
actionPerformedQ'ava.awt.event.ActionEvent evt) { 



action2(evt); 



} 



}); 



jButton3.setText("Exit"); 



jButton3.addActionListener(new 

java.awt.event.ActionListener() { 
public void 
actionPerformed(java.awt.event.ActionEvent evt) { 



action3(evt); 



} 



}); 



Abbiamo aggiunto anche un terzo bottone per usci- 
re dall'applicazione. Di seguito mostriamo lo sche- 
letro dei tre metodi che verranno richiamati quando 
uno dei bottoni verrà premuto. 

private void action3(java.awt.event.ActionEvent evt) { 
System. out.println("Uscita dall'applicazione"); 
System, exit(l); 

} 

private void action2(java.awt.event.ActionEvent evt) { 
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// Codice per l'estrazione del testo dai PDF 



} 



private void actionlQ'ava.awt.event.ActionEvent evt) { 
// Codice per la trasformazione da PDF a 

immagini 



} 



Chiaramente l'interfaccia grafica è molto scarna e 
potremmo abbellirla con qualche Look&Feel più 
accattivamente. I Look&Feel Swing permettono di 
cambiare il layout dell'interfaccia grafica in maniera 
semplice. Per questa applicazione è stato scelto di 
utilizzare il L&F substance, che potete trovare dispo- 
nibile per il download all'indirizzo https://substan- 
ce.dev.java.net . Il layout di default di questo L&F 
assomiglia molto alle gui che possiamo vedere su 
MacOS X. Per utilizzarlo nella nostra interfaccia non 
dobbiamo far altro richiamare la classe UIManager 
e dichiarare di volerlo utilizzare. 



try 

{ 

UIManager.setLookAndFeel("org.jvnet.substance.Substan 

ceLookAndFeel"); 

} 

catch(Exception e) { 

System. out.println(e.toString()); 
} 



Potete ammirare quindi la nostra interfaccia nel- 
l'immagine di seguito. 



I |£ IpodConverter by IoProqrammo 



Jflix| 



IpodConverter 



PDF to image 



C~ PDF to t 



Fig. 1: Screenshot della nostra applicazione 

Torniamo ora a concentrare la nostra attenzione 
sulle funzionalità del nostro programma, imple- 
mentando una dopo l'altra le funzionalità 
dichiarate. 



DA PDF A TESTO 

Il pdf è un formato molto comune ed esistono al 
giorno d'oggi molti tool che permettono di salvare 
un documento in questo formato. Purtroppo questo 
tipo di file non è supportato dall'IPOD per la visua- 
lizzazione, quindi dobbiamo ingegnarci per ottene- 
re come prima cosa il testo di un intero file pdf e 
poterlo leggere nelle Note dell'IPOD. Prima di tutto 



dobbiamo utilizzare una libreria esterna che ci per- 
metta di interagire con file pdf, visto che le librerie 
standard di Java non prevedono niente al riguardo. 
Nel panorama delle librerie opensource Java dispo- 
niamo di diverse scelte. In questo articolo utilizzere- 
mo JPedal, una libreria opensource rilasciata con 
licenza duale: GPL e commerciale. Questa libreria 
nasce nel lontano 1997 e nel tempo è stata costante- 
mente aggiornata, sinonimo di affidabilità del grup- 
po che ne sostiene lo sviluppo. Attualmente è arriva- 
ta alla versione 2.8. Possiamo scaricarla dal sito uffi- 
ciale http://www.jpedal.org /. Alcune fra le feature 
disponibili con Jpedal sono le seguenti: 

• Supporto alle form pdf (form che possiamo trova- 
re all'interno di file pdf e ci permettono di inserire 
valori) 

• Estrazione del testo 

• Estrazione delle immagini 

• Visualizzatore pdf 

• Support per il Font 

• Support per il Mac 

• API alternativa per la stampa 
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Fig. 2: Homepage del sito di JPedal 

Iniziamo quindi a sviluppare la parte del nostro pro- 
gramma che permetterà di estrarre il testo dai file 
pdf. Il metodo relativo all'estrazione del testo è 
action2() che andiamo qui sotto ad implementare 

JFileChooser fileChooser = new JFileChooser(new 

FNe("C:\\")); 

fileChooser.addChoosableFileFilter(new FiltroPdf()); 
// Open file dialog. 
fileChooser.showOpenDialog(this); 
File f=fileChooser.getSelectedFile(); 
if (f!=null) { 

System. out.println("Inizia estrazione testo"); 
Estratto reTesto et=new 

EstrattoreTesto(f.getAbsolutePath(),this); 
et.estraiQ; 



Prima di tutto facciamo in modo che l'utente possa 




Una libreria offerta 
dalla Apple, QuickTime 
for Java, può essere 
usata per convertire 
file audio-video, 
adattandoli allo 
standard riconosciuto 
dal IPOD. 

http://developer.apple.co 
m/quicktime/qtjava/ 
http://www.onjava.eom/p 
ub/a/onjava/2003/05/1 4/q 
tj reintro.html 
http://www- 

1 28.ibm.com/developerw 
orks/wireless/library/wi- 
mvideo/?ca=dgr- 
Inxwl 7CreatelPODvideo 
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E' possibile vedere 

altri Look&Feel, per 

migliorare la grafica 

della nostra 

applicazione, 

collegandosi al sito 

http://www.javootoo.com 



^> 



scegliere il file PDF da elaborare. Lo facciamo 
utilizzando la classe Java Swing JFileChooser e appli- 
candovi un filtro che restringa la scelta a directory e 
file con estensione .pdf 

package com.ioprogrammo.ipodconverter; 

import java. io.*; 

public class FiltroPdf extends 

javax. swing. filechooser. FileFilter { 

public boolean accept(File file) { 



public void estraiQ { 



String filename = file.getl\lame(); 



return 

(filename.endsWith(".pdf") || (file. isDirectory())); 



} 



public String getDescriptionQ { 



return "*.pdf"j 



} 



Una volta che l'utente ha selezionato un file pdf, 
siamo pronti per estrarne il testo. Quasi sicuramen- 
te si tratterà di un processo lungo, quindi la classe 
che se ne occuperà dovrà essere un Thread. In que- 
sto modo non ci saranno blocchi dell'interfaccia 
grafica. All'interno della libreria JPedal è presente un 
esempio utile (ExtractTextAsWordlist) che abbiamo 
riadattato per una migliore integrazione con il 
nostro programma grafico. 

package com.ioprogrammo.ipodconverter; 

import java. io.*; 
import java.util.Iterator; 
import java. util. List; 
import java.util.Vector; 
import javax. swing JOptionPane; 
import org.jpedal.PdfDecoder; 
import org.jpedal.exception.PdfException; 
import org.jpedal.exception.PdfSecurityException; 
import org.jpedal.grouping.PdfGroupingAlgorithms; 
import org.jpedal.objects.PdfPageData; 
import org.jpedal.utils.LogWriter; 
import org.jpedal.utils. Strip; 
public class Estratto reTesto extends Thread { 
private String filename; 
private int wo rds Extra cted; 

private PdfDecoder decodePdf; 

private String outputDir; 

private IpodConverter frame; 



public EstrattoreTesto(String 

filename,IpodConverter frame) { 
this.filename=filename; 
this.frame=frame; 



this.start(); 



} 



Nel metodo run() di questo Thread andremo ad 
estrarre il testo. La prima cosa che facciamo è aprire 
il file utilizzando la classe PdfDecoder della libreria 
JPedal 

public void run() { 

PdfDecoder.useTextExtraction(); 
outputDir ="c:\\IpodConverter\\"; 

tryj 

decodePdf = new PdfDecoder(false); 
decodePdf.setExtractionMode(l); 
decodePdf.init(true); 
PdfGroupingAlgorithms.useUnrotatedCoords 

= false; 
System. out.println("Apertura file :" + 

filename); 
decodePdf.openPdfFile(filename); 

} 

catch(Exception ex) { 

System. out.println(ex.toString()); 
} 



Una volta aperto il file dobbiamo vedere se sono 
presenti delle restrizioni sul file pdf, tipo password o 
permessi negati 

if(decodePdf.isEncrypted() && 

!decodePdf.isPasswordSupplied() && 
!decodePdf.isExtractionAllowed()) { 
System. out.println("Impossibile eseguire 
l'estrazione per politiche di sicurezza sul file"); 
~T~ 

Se il pdf non ricade in nessuno di questi casi possia- 
mo iniziare a prendere il testo. Questo lavoro viene 
svolto pagina per pagina, dando le coordinate della 
pagina ad una classe di JPedal che estrae un vettore 
con il testo. Quello che noi dobbiamo fare è calcola- 
re quante pagine sono presenti, fare un ciclo for e su 
ogni pagina ottenere il testo e scriverlo su file. 

else { 

boolean flag = true; 

int j = decodePdf.getPageCount(); 

try{ 



forflnt k = ((flag) ? 1 : 0); k < j + 1; 



k++) 



{ 



decodePdf.decodePage(k); 



PdfGroupingAlgorithms 
pdfgroupingalgorithms = decodePdf.getGroupingObjectQ; 



PdfPageData pdfpagedata = 

decodePdf.getPdfPageData(); 
int I = pdfpagedata. getMediaBoxX(k); 
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^ 



int il = 

pdfpagedata.getMediaBoxWidth(k) + I; 
int jl = pdfpagedata.getMediaBoxX(k); 
int kl = 

pdfpagedata.getMediaBoxHeight(k) - jl; 
System. out.println("Estrazione pagina 

"+k); 

Vector vector = nuli; 

try^ 

vector = 
pdfgroupingalgorithms.extractTextAsWordlist(l, kl, il, jl, 

k, false, true, "&:=()! ;.,\V\"\"""); 

} 

catch(PdfException ex) 

{ 

decodePdf.closePdfFile(); 
System. err.println("Eccezione = " + 
ex ); 

} 

if( vector == nuli) { 

System. out.println("Testo non 

trovato"); 



else { 

File file = new File(outputDir); 

if(!file.exists()) 

file.mkdirsO; 
int 11 = vector.size() / 5; 
wordsExtracted = words Extra cted + 

11; 
OutputStreamWriter 
outputstreamwriter = new OutputStreamWriter(new 
FileOutputStream(outputDir + "pagina-" + k + ".txt"), 

"UTF-8"); 

String s2; 
int i2; 

int j2; 

int k2; 
int 12; 

for(Iterator iterator = 
vector.iterator(); iterator. hasNext(); 
outputstreamwriter.write(s2+" ")) { 
s2 = (String)iterator.next(); 
s2 = Strip, co nvertToText(s2); 
i2 = 
(int)Float.parseFloat((String)iterator.next()); 

J2 = 
(int)Float.parseFloat((String)iterator.next()); 

k2 = 
(int)Float.parseFloat((String)iterator.next()); 

12 = 
(int)Float.parseFloat((String)iterator.next()); 

} 
outputstreamwriter.closeO; 

} 
decodePdf.flushObjectValues(false); 



} 



catch(Exception ex) 



{ 



decodePdf.closePdfFile(); 



System. err.println("Eccezione: " + ex); 



ex.printStackTrace(); 



} 



decodePdf.flushObjectValues(true); 



System. out.println("Testo letto"); 



} 



decodePdf.closePdfFile(); 



decodePdf = nuli; 



JOptionPane.showMessageDialog(frame,"Estrazione 

effettuata"); 



} 



Il salvataggio delle diverse pagine viene effettuato 
nella cartella C:\\IpodConverter, salvando ogni 
pagina su un file diverso. Quando la conversione ter- 
mina viene utilizzata la classe JOptionPane per 
comunicare la fine del lavoro. Questi file di testo che 
abbiamo realizzato possono essere letti facilmente 
su un IPOD come note, trasferendoli nella cartella 
Notes che 1ÌPOD mette a disposizione quando lo 
esploriamo come un disco esterno. Chiaramente la 
conversione non è perfetta perché non tutti i pdf 
sono uguali. In molte prove la conversione è andata 
bene, in alcuni casi vengono mischiati nel testo dei 
caratteri strani che JPedal non riesce ad eliminare. 



DA PDF A IMMAGINI 

La maggior parte dei file pdf che ci capita di leggere 
sono alla fine delle presentazioni. Proprio per que- 
sto motivo sarebbe molto interessante poter trasfe- 
rire questi file sul nostro IPOD per poterli visualizza- 
re quando vogliamo. Possiamo immaginare il file 
pdf come una serie di slide, una per pagina, che pos- 
siamo riprodurre sequenzialmente. Anche in questo 
caso la libreria JPedal può essere d'aiuto. Infatti uti- 
lizzando questa libreria è possibile vedere ogni pagi- 
na di un pdf come un'immagine e quindi salvarla e 
ridimensionarla come vogliamo. Anche in questo 
caso deleghiamo tutto il lavoro ad un classe esterna 
che agisce come Thread per non bloccare l'interfac- 
cia grafica. 

JFileChooser fileChooser = new JFileChooser(new 

File("C:\\")); 

fileChooser.addChoosableFileFilter(new FiltroPdf()); 
fileChooser.showOpenDialog(this); 
File f=fileChooser.getSelectedFile(); 
if (f!=null) { 



System. out.println("Inizia estrazione 



immagini"); 




C9^B 

Esistono già altri 
programmi e metodi 
che permettono di 
convertire diversi 
formati di file per 
l'IPOD 

http://www. nuli river.com/ 
index/products/moviepod 
http://www.alloksoft.com 
/i podconverter.htm 
http://www.engadget.co 
m/2004/1 1/1 6/how-to- 
put-powerpoint-on-your- 
ipod-photo/ 



Estrattorelmmagini ei=new 

EstrattoreImmagini(f.getAbsolutePath(),this); 
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ei.estraiQ; 



l,BufferedImage.SCALE_SMOOTH); 



} 



La classe Estrattorelmmagini viene inizializzata 
come EstrattoreTesto, passando il riferimento alla 
classe IpodConverter. Come prima viene istanziato 
un PdfDecoder, ma in questo caso viene specificato 
anche un parametro addizionale riguardamento la 
modalità di estrazione 

try{ 

decodePdf = new PdfDecoder(true); 
decodePdf.setExtractionMode(0, 72,dpi/72); 
decodePdf.openPdfFile(filename); 
} catch (Exception e) { 

System. out.println("Errore nell'inizializzazion di 
PdfDecoder: "+e.toString()); 
T~ 

A questo punto, se non ci sono problemi di sicurez- 
za del pdf (criptato o con password) possiamo ini- 
ziare a scorrere tutte le pagine in un ciclo for e pren- 
dere l'immagine relativa ad ogni pagina 

File output = new File("c:\\IpodConverter\\"); 
if (output.exists() == false) 
output. mkdirsQ; 



image_to_save = new 

BufferedImage(scaledImage.getWidth(null),scaledImage. 
getHeight(null) , BufferedImage.TYPE_INT_RGB); 
Graphics2D g2 = image_to_save.createGraphics(); 
g2.drawlmage(scaledlmage, 0, 0,null); 

La variabile di ridimensionamento ci avrebbe per- 
messo di stabilire la percentuale di riduzione del- 
l'immagine. Passiamo ora al salvataggio dell'imma- 
gine sul nostro computer per concludere la funzio- 
nalità 

boolean 

failed=decodePdf.getObjectStore().saveStoredImage( 



"c:\\IpodConverter\\" + page 



+ image_name, 



image_to_save, 



true, 



false, 



format); 

Per poter utilizzare queste classi grafiche dobbiamo 
inserire nel nostro classpath anche JAI (Java 
Advanced Imaging,), la libreria della SUN che 
aggiunge funzionalità grafiche a quelle standard 
fhttp://java.sun.com/products/java-media/jai) . 



^> 




L'autore, Federico 

Paparoni, può essere 

contattato per 

suggerimenti o 

delucidazioni 

all'indirizzo email 

federico.paparoni@javast 

aff.com 



int end = decodePdf.getPageCount(); 

try{ 

for (int page = l;page < end + l;page++) { 
String image_name ="page_" + page; 
PdfFilelnformation 
currentFileInformation=decodePdf.getFileInformationData 

0; 



Bufferedlmage image_to_save 

=decodePdf.getPageAsImage(page); 

A questo punto dovremmo effettuare il ridimensio- 
namento dell'immagine. Dal punto di vista della 
qualità, trasformando l'immagine perdiamo qualco- 
sa. Inoltre difficilmente otterremo un'immagine 
della lunghezza e larghezza giusta per l'IPOD. Infine 
i file delle immagini potrebbero essere utili anche in 
altri contesti, diversi dall'IPOD. Insomma diverse 
cose fanno pensare che sia inutile scrivere questo 
pezzo di codice nel nostro programma, anche per- 
ché iTunes ottimizza le immagini quando le voglia- 
mo trasferire sul dispositivo. Comunque giusto per 
curiosità quello che avremmo dovuto fare viene 
riportato nel seguente codice 



int 








newWidth= 


=image_to. 


_sav€ 


.getWidth()*ridimensionament 
O/100; 


Image scaledlmage= 








image_to_ 


save 


getScaledInstance(newWidth,- 



CONCLUSIONI 

Facendo un test della nostra applicazione 
vediamo quanto sia semplice ora poter leggere 
pdf in diverse modalità sul nostro IPOD. 



& 



~H HfllIslfsTt 



li ■ My eBooks 


bgpl.pdf 


pagerank.pdf 


les E3 My Music 


bgp2.pdf 




Q My Publications 


bgp3.pdf 




Fi My Skype Pictures 
E3 Siti Web 


hits.pdf 


if 


IBM_REDBOOK_BGP.pdf 


BGP.pdf 


IBM_REDBOOK_IPMOBILE.p 


fT 


t 


) >l 



Nome file: | 
Tipo file: r 



pdf 



f^ 



f Apri ' * Annulla 



Fig. 3: Selezione dei pdf da convertire 

Chiaramente questa è un'applicazione che può 
essere migliorata molto, inserendo il supporto ad 
altri formati di file, ad esempio la conversione di 
video in mp4, creazione di immagini a partire da 
altri file oltre ai pdf (powerpoint ad esempio) etc. etc. 
Come sempre la creatività è il punto di partenza per 
le applicazioni più interessanti. 

Federico Paparoni 
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PROGRAMMARE 
.NET CON PYTHON 

LA DIFFUSIONE DI PYTHON COME LINGUAGGIO DI PROGRAMMAZIONE HA QUASI 
RAGGIUNTO QUELLA DI .NET, E CON IRONPYTHON È ORA POSSIBILE SCRIVERE SCRIPT 
IN PYTHON E COMPILARLI PER LA PIATTAFORMA MICROSOFT 



Python è un linguaggio di programmazione 
potente, di facile apprendimento, e che 
permette di utilizzare diversi paradigmi di 
sviluppo. In particolare, il suo approccio alla pro- 
grammazione orientata agli oggetti è semplice 
ma estremamente efficace. Grazie alla sua sintas- 
si, alla tipizzazione dinamica, ed alla natura di 
linguaggio interpretato, si presta particolarmen- 
te per lo scripting e lo sviluppo rapido di applica- 
zioni multipiattaforma. 

Con IronPython, il linguaggio Python incontra il 
mondo .NET. IronPython è infatti un'implemen- 
tazione del linguaggio per il CLR, integrato per- 
fettamente con il mondo .NET, rendendo dun- 
que le librerie del framework Microsoft utilizza- 
bili da Python, mantenendo allo stesso tempo la 
totale compatibilità con il linguaggio python ori- 
ginale. 

In questo articolo si vedrà come utilizzare la con- 
sole interattiva di (Iron) Python, come utilizzare 
gli assembly .NET standard in Python, e come 
scrivere invece librerie in Python per integrarle e 
utilizzarle nelle applicazioni .NET. 



LA CONSOLE DI PYTHON 

Una volta scaricato il pacchetto dei binari di 
IronPython l'installazione non richiede nessuna 
operazione particolarmente complessa. Basta 
decomprimere i file in una cartella a vostra scel- 
ta, ed avrete già tutti gli strumenti necessari a 
disposizione. 

Python possiede una console interattiva, una 
caratteristica fondamentale del linguaggio che 
dunque non poteva mancare ad IronPython. Fra 
i file sarà dunque presente l'eseguibile ipy.exe, 
che una volta lanciato eseguirà proprio l'inter- 
prete, presentandovi un prompt dei comandi 
pronto a ricevere ed eseguire istruzioni in 
python, come mostrato di seguito: 

IronPython 1.0 (1.0.61005.1977) on .NET 



2.0.50727.42 



Copyright (e) Microsoft Corporation. Ali rights 



reserved. 



Chi conoscesse Python, la sua sintassi e le sue 
librerie può anche saltare questa parte, chi inve- 
ce non ha mai scritto una sola riga di Python, e 
non conosce dunque la console interattiva, può 
eseguire i seguenti esempi almeno per provarne 
il funzionamento. 

La console interattiva può essere utilizzata come 
calcolatrice! Si provi ad esempio ad inserire delle 
istruzioni aritmetiche e : 



>>> 


1 + 1 




2 


>>> 


343* 


2 


686 


>>> 



Al prompt possiamo anche eseguire del codice 
più articolato, che verrà immediatamente inter- 
pretato. Per esempio un ciclo for in python per 
stampare i primi dieci numeri viene scritto così: 



>>> for i in range(l,10): 



print i 

Si noti come Python non utilizza alcun delimita- 
tore di blocco, per esempio le parentesi graffe di 
C#, ma è basato esclusivamente sulla corretta 
indentazione del codice. Quindi si presti atten- 
zione alla scrittura del codice. Per utilizzare le 
librerie di python dette moduli, si utilizza la fun- 
zione import, per esempio così: 

>>> import sys 

Per conoscere il contenuto del modulo sys si può 
utilizzare la funzione dir: 

>>> dir(sys) 




Q CD U WEB 

_ex.zip 



VL 



fi 




REQUISITI 



■ MIN I ' BM 

l i Conoscenze di base di 
! NET e Python 



IronPython 1.0, .NET 
Framework 2.0 



©è 



j 



Tempo di realizzazione 
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INTERPRETE 
INTERATTIVO 

Per potere eseguire 

l'interprete interattivo 

da qualunque 

locazione del file 

system, è suggerito 

aggiungere il percorso 

contenente i file di 

IronPython, e quindi 

ipy.exe, alla variabile 

PATH di sistema. 

L'eseguibile ipiw.exe 

serve a lanciare 

l'interprete senza un 

prompt dei comandi, 

quindi si utilizza per 

applicazioni Windows. 



^> 



Il modulo, fra gli altri, conterrà degli attributi, per 
esempio version che rappresenta la versione del- 
l'ambiente. Per visualizzare il valore basta ese- 
guire il comando seguente: 



#esempio script ironpython 



>>> sys 


version 






'IronPyth 


on 1.0 (1.0.61005.1977) 


on 


.NET 

2.0.50727.42' 


>>> 



UTILIZZARE 
LE LIBRERIE 

Per utilizzare le classi librerie del framework 
.NET dalla console interattiva di Python, o da 
uno script Python qualunque, basta utilizzare 
ancora la funzione Import. 
Per esempio, se si vuol utilizzare la classe 
Console del namespace System, si può scrivere: 



>>> 


import System 




>>> 


System. Console. WriteLine('Hello') 


Hello 


>>> 



In questo caso è necessario utilizzare il nome 
completo, cioè comprensivo di System. In caso 
contrario si otterrebbe infatti un errore di man- 
cata definizione: 



>>> Console. WriteLine('Hello') 



Traceback (most recent cali last): 



File , line 0, in <stdin>##31 



NameError: name 'Console' not defined 

La funzione import può essere però utilizzata 
anche per importare il suo contenuto oppure 
una particolare classe nel namespace globale. 
Per esempio: 



>>> 


from System 


import * 


>>> 


Console. WriteLine('Hello') 


Hello 


>>> 



Per eseguire uno script python, basta salvarlo in 
un file con estensione .py e poi eseguire il 
comando 



from System import 



from System. Collections.Generic import : 



lista = List[String]() 



lista. Add('ciao') 



lista.Add('da') 



lista. Add('IoProgrammo') 



for elemento in lista: 



Console. Write(elemento+' ') 

Salvate il codice precedente nel file esempio l.py 
ed eseguite 'ipy esempio l.py'. Il risultato sarà la 
visualizzazione della stringa 'Ciao da 
IoProgrammo'. 

IronPython può importare direttamente solo 
alcune delle librerie di .NET, cioè quelle stan- 
dard. Per le rimanenti, oppure per quelle create 
da noi in C#, in VB.NET o in un qualunque lin- 
guaggio .NET, è necessario qualche operazione 
in più. 

Innanzitutto creiamo un semplice assembly 
.NET, per esempio in C#. Create un file con la 
seguente classe C#, il cui unico metodo calcola il 
quadrato di un intero: 



using System; 




public 


class MathLib 


{ 




public 


int Quadrato(int i) 


{ 


return i*i; 


} 


} 



Dopo aver salvato tale classe in un file, per esem- 
pio MathLib.cs, bisogna compilare il file in modo 
da ottenere una libreria. Con il compilatore da 
riga di comando esc basta eseguire il comando: 

esc /target: library MathLib.cs 

Il risultato sarà T assembly MathLib.dll. Adesso 
creiamo un altro script python all'interno del 
quale utilizzeremo F assembly MathLib, e per far 
ciò bisogna utilizzare il modulo clr, ed in partico- 
lare il metodo AddReferenceToFile: 



ipy nomefile.py 

Proviamo a scrivere un semplice esempio che 
utilizza le librerie .NET, ed in particolare i gene- 
rics. 

Per questi ultimi è necessario utilizzare le paren- 
tesi quadre per il tipo argomento, e non < e > 
come si fa in .NET. 



import clr 



clr.AddReferenceToFileCMathLib.dll") 



import MathLib 
m=MathLib() 



for i in range(l,ll): 



print m.Quadrato(i) 



Salvando lo script nel file esempio2.py e dandolo 
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in pasto a ipy.exe si otterrà in output il quadrato 
dei primi dieci numeri interi. 



UTILIZZO DELLE 
WINDOWS FORMS 

Ora che siamo entrati nei meccanismi fondamen- 
tali di IronPython e abbiamo scoperto come utiliz- 
zare le librerie .NET, possiamo anche affrontare la 
programmazione Windows Forms. 
Non è niente di particolare, conoscendo le basi. Il 
seguente script crea una classica Form e la utilizza 
come finestra principale dell'applicazione, si noti 
l'utilizzo del metodo AddReferenceBy PartialName 
del modulo clr utilizzato per importare l'assembly 
System.Windows.Forms dalla GAC: 

import clr 

clr. AddReferenceByPartialName("System. Windows. Forms" 

)_ 

from System.Windows.Forms import * 
class MainForm(Form): 

def init (self): 

self.Text = 'Hello World' 
Application. Run(MainForm()) 

Nell'esempio viene creata una classe MainForm 
derivata dalla classe base Form. Il metodo 

init è il costruttore della classe, all'interno 

del quale viene solo inizializzato il testo sulla 
barra del titolo. 

Si noti che ogni metodo di classe ha come primo 
parametro la variabile self, che rappresenta l'i- 
stanza della classe attuale (il this di C#). 
Questo semplice esempio potrebbe già entusia- 
smare gli amanti di Python, invogliandoli a pro- 
vare anche lo sviluppo per la piattaforma .NET, 
senza abbandonare il proprio linguaggio preferi- 
to, come d'altronde fa chi sviluppa in C#, o in 
VB.NET, o in C++, e così via. 
Tra l'altro ciò consente di creare applicazioni gra- 
fiche senza dover far ricorso ad altre librerie, in 
quanto i namespace System.Windows.Forms, 
System. Drawing e così via hanno tutto ciò che 
serve. Proviamo dunque un'applicazione più 
complessa, con gestione degli eventi e disegno 
su una Form, riprendendo l'esempio precedente. 

class MainForm(Form): 

def init (self): 

self.Text = 'Hello World' 
self.FormClosing += self.formClosing 
self.InitializeComponents() 

nel costruttore viene gestito l'evento Form 
Closing della Form ed invocato il metodo 
InitializeComponents, che crea l'interfaccia gra- 



fica come qui di seguito: 



def InitializeComponents(self): 



bt=Button() 



bt.Text= "Clicca qui" 



bt.Click += self.bt_Click 



bt.Location = Point(10,10) 



bt.Size=Size(80,30) 



self.Controls.Add(bt) 



self.MouseDown+=self.formMouseDown 

Nel metodo InitializeComponents viene creato 
un pulsante bt, impostate le sue proprietà, ed il 
metodo che gestisce l'evento Click, definito fra 
poco. Poi il pulsante viene aggiunto alla collezio- 
ne Controls della Form. L'ultima istruzione inve- 
ce aggiunge il metodo formMouseDown come 
gestore dell'evento MouseDown della Form. 



def formClosing(self, sender, e): 




result 


= MessageBox.Show 


("Vuoi 


uscire?", "", 


MessageBoxButtons.YesNo) 




if resu 


t == DialogResult.No: 


e.Cancel = True 


return 



Il metodo formClosing gestisce l'evento 
FormClosing, che viene scatenato quando l'u- 
tente tenta di chiudere la finestra. In questo 
caso viene visualizzata una MessageBox con i 
pulsanti sì e no, per confermare o meno l'uscita 
dall'applicazione. In caso negativo viene impo- 
stato il valore e.Cancel a true per annullare l'e- 
vento di chiusura. 



def bt_Click(self,sender,e): 



MessageBox. Show("Hai cliccato il pulsante!") 
Il metodo bt_Click gestisce come visto l'evento 



m Hello World 



- n X 





IRONPYTHON 
SU CODEPLEX 

Il progetto IronPython, 
è ospitato su 
CodePlex, dal quale 
potete ottenere sia il 
pacchetto dei binari, 
ma anche i sorgenti 
del progetto, insiemi a 
diversi esempi e 
tutorial. L'indirizzo 
ufficiale del progetto 
IronPython è 
http://www.codeplex.c 
om/Wiki/View.aspx?Pr 
ojectName=lronPytho. 



Fig. 1: un'applicazione Windows Forms in python 



http://www.ioprogrammo.it 



Gennaio 2007/ 81 ► 



079-083 28-11-2006 11:21 Pagina 82 



SISTEMA T I Alla scoperta di ironPython 




di clic sul pulsante bt, non fa niente di particola- 
re in questo caso, solo visualizzare una 
MessageBox per verificare che in effetti l'evento 
viene gestito. 

Infine vediamo il metodo formMouseDown, che 
fa uso delle funzioni di disegno del namespace 
System. Drawing. 

def formMouseDown(self,sender,e) : 
gfx=self.CreateGraphics() 
gfx.FillEllipse(Pens.Red,e.X,e.Y,10,10) 

Ad ogni clic sulla superficie della Form viene 
disegnato un cerchio rosso. Dopo aver salvato il 
codice precedente in un file winapp.py, basta 
lanciare il comando ipy.exe winapp.py. La figura 
seguente mostra l'applicazione in esecuzione. 



IL MOTORE DI PYTHON 

È possibile utilizzare l'engine di Python all'inter- 
no di una classica applicazione .NET, ed utilizza- 
re quindi le sue funzionalità. Abbiamo per esem- 
pio visto come utilizzare la console di python 
come calcolatrice, e ciò suggerisce che sarebbe 
possibile utilizzare l'interprete per valutare delle 
espressioni oppure per dotare le applicazioni 
.NET di funzioni di scripting, cosa per la quale 
python sta probabilmente divenendo il linguag- 
gio preferito dai più. 

Valutare un'espressione è un'operazione che 
suggerisce come possibile applicazione il dise- 
gno del grafico di una funzione. Come esempio 
quindi, si realizzerà una semplice applicazione 







r~5»> i — * -^ —x •» 








X * 









Fig. 2: L'interfaccia utente per lo studio di una funzione 

Windows, che permetta di disegnare tale grafico, 
nel caso di una funzione ad una sola variabile x, 
sfruttando python per calcolarne i valori su un 
dato dominio di x. 

La classe che rappresenta e permette di utilizza- 
re il motore dell'interprete Python è 
PythonEngine, le cui istanze possono essere con- 
trollate da una qualunque applicazione host 
scritta in .NET. 
Un'istanza PythonEngine permette di effettuare 



qualunque operazione eseguibile da Python, e 
dunque ognuna di quelle che abbiamo visto uti- 
lizzando la console interattiva. 
Nel nostro caso, un PythonEngine servirà ad ese- 
guire una semplice istruzione di assegnamento 
alla variabile x, lungo tutto il suo dominio e poi a 
valutare un'espressione rappresentata da una 
funzione ad una variabile. 

Dopo aver preparato un'interfaccia grafica in C#, 
che permetta di inserire la funzione e l'intervallo 
dei domini, e che contenga un pannello sul quale 
disegnare la funzione (rappresentata in figura 2, 
codice presente nel CD allegato), andiamo a 
vedere come utilizzare la classe PythonEngine. 
Creiamo una classe helper che crei e mantenga 
l'istanza PythonEngine, in questo modo: 

class IronPythonHelper 

{ 

private PythonEngine engine; 



public IronPythonHelper() 



{ 



InitializePyEngineQ; 



} 



void InitializePyEngineQ 



{ 



engine = new PythonEngineQ; 



//esegui altre inizializzazioni 



engine. Import("sys"); 



engine. Execute("from math import *"); 



> 



Nel metodo InitializePyEngine sarà possibile 
eseguire operazioni di inizializzazione addizio- 
nali, come per esempio importare moduli, in 
questo caso l'importazione del modulo math è 
praticamente obbligatorio per calcolare funzioni 
più complesse, come quelle trigonometriche. 
Il processo sarà quello di calcolare il valore di 
una funzione, su tutti i punti del dominio della 
variabile X. Quindi prima di tutto si assegnerà 
alla variabile x un valore, eseguendo l'istruzione 
di assegnazione python del tipo: 

x=valore 

Per eseguire una qualunque istruzione Python, la 
classe PythonEngine mette a disposizione il 
metodo Execute, con diversi overload. In questo 
caso, basterà creare una stringa "x=valore", dove 
valore sarà di volta in volta un diverso elemento 
del dominio, e poi dare in ingresso la stessa strin- 
ga al metodo PythonEngine.Execute. 
Assegnato il valore alla variabile x si potrà proce- 
dere con il valutare la funzione, semplicemente 
invocando il metodo EvaluateAs, che valuta un'e- 
spressione Python restituendo un valore di un 
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tipo predeterminato. In definitiva tutto ciò che 
serve è un metodo C# come il seguente: 

public doublé EvaluateFunction(string function, 

string varName, doublé varValue) 
{ 
try 

i 

engine.Execute(varName + "=" + varValue); 
return engine.EvaluateAs<double>(function); 



} 



catch 



{ 



throw; 



} 



Supponendo che la funzione sia rappresentata 
dalla stringa "x*x+l", e di volerla valutare nel 
punto di ascissa x=0, si invocherà il metodo 
EvaluateFunction così: 

doublé v=EvaluateFunction("x*x+l","x",0); 

In questo caso y assumerà il valore 1. Per calcolare 
il valore della funzione su tutti i punti dell'interval- 
lo scelto, basterà un ciclo for, e per comodità si con- 
serveranno le coppie di punti che costituiscono il 
grafico della funzione in un oggetto List<Point>. Se 
min e max rappresentano rispettivamente l'estre- 
mo inferiore e quello superiore del dominio di x, e 
lo step che vogliamo utilizzare è di 0.05, il ciclo sarà 
fatto come segue: 
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F/gf. 3: Il disegno di una funzione ad una variabile 



python = new IronPythonHelper(); 

for (doublé x = min; x < max; x += 0.05) 

{ 

y = python. EvaluateFunction 

(txtExpression.Text, "x", x); 
points.Add(new PointF((float)x,(float)y)); 



A questo punto non resta che trasformare i valo- 
ri reali in valori compatibili con le coordinate 
dello schermo, ed in particolare del Panel utiliz- 



zato e disegnare una spezzata formata dall'unio- 
ne di tutti i punti ottenuti. Lasciamo perdere la 
spiegazione nei dettagli, che esula dallo scopo 
dell'articolo, mostrando solo il codice C#: 

private void TranslatePoints() 

{ 

float incr = ((float) panell.Width) / 

points.Count; 
pointsArray = new PointF[points.Count]; 
PointF pt; 
PointF ptO=new 

PointF(panell.Width/2,panell.Height/2); 
for (int i = 0; i < points.Count; i++) 



{ 



pt = new PointFQ; 



pt.X = i*incr; 



pt.Y = (ptO.Y- 

yscale*((float)points[i].Y)/panell.Height); 



pointsArray[i]=pt; 



} 



private void panel l_Paint(object sender, 



PaintEventArgs e) 



Graphics gfx = e. Graphics; 



gfx.Drawl_ine(Pens.Red,new 

Point(panell.Width/2,0),new 



Point(panell.Width/2,panell.Height)); 



gfx.DrawLine(Pens.Red, new Point(0, 

panell.Height / 2), new Point(panell.Width, 

panell.Height/ 2)); 

if (pointsArray != nuli && pointsArray. Length > 



0) 



gfx.DrawLines(Pens.Black,pointsArray); 





Antonio Pelleriti è 
ingegnere informatico 
e si occupa di .NET sin 
dalla prima versione 
beta. Potete rivolgere 
domande di 
chiarimenti o ulteriori 
richieste all'autore sul 
forum di 
loProgrammo 
(forum, ioprogrammo.i 
t) o sul sito 
www.dotnetarchitects.it . 



} 



L'applicazione completa e funzionante è mostra- 
ta in figura 3, mentre disegna una funzione abba- 
stanza complessa. 

Antonio Pelleriti 



INSTALLAZIONE DEI PREREQUISITI 



È possibile effettuare il debug 
degli script IronPython da 
Visual Studio. 

Utilizzando il comando File- 
>Open->Project/Solution ... si 
apra il file ipy.exe. 
Facendo clic con il destro su 
ipy.exe nel Solution Explorer si 
selezioni Properties. Nella 
finestra delle proprietà 
bisogna riempire i due campi 
Command Arguments, 



inserendo il nome del file da 
debuggare e Working 
Directory, inserendo il path 
della directory in cui si trova il 
file. 

Adesso si salvi la soluzione. 
Per debuggare il file, basta 
aprirlo con il comando File- 
>Open, impostare i breakpoint 
e premere F5 per far partire il 
debug. 
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SOFTWARE 
INTERNAZIONALE 

IN UN EPOCA IN CUI LE DISTANZE SI SONO ORMAI ANNULLATE, È IMPORTANTE 
PRODURRE APPLICAZIONI FRUIBILI IN OGNI PARTE DEL MONDO. IL PRINCIPIO BASE 
È LA LOCALIZZAZIONE. VEDIAMO COME SCRIVERE CODICE MULTILINGUA 





A distanza di alcuni anni dalla nascita del 
World Wide Web e dall' affermarsi della 
comunicazione globale, la sensazione 
ancora viva in molti è quella di "avere il mondo in 
casa e di poter essere in ogni parte del mondo 
con un semplice click". Per sfruttare al massimo 
questa potenzialità, chi realizza siti web o appli- 
cazioni e intende farne conoscere il contenuto in 
uno spazio geografico quanto più ampio possibi- 
le deve disporre di strumenti che rendano i suoi 
prodotti "universali", comprensibili appunto "in 
ogni parte del mondo". Spiegare quali siano que- 
sti strumenti è l'obiettivo del presente articolo. 



testi da database: le applicazioni moderne 
fanno largo uso di contenuti provenienti da 
database, come, ad esempio, un catalogo in cui 
sono contenute le caratteristiche di alcuni pro- 
dotti. 

date, numeri: anche se queste informazioni 
non devono essere "tradotte", andranno, 
comunque, visualizzate in modo diverso in 
base alla lingua di destinazione. Pensiamo, al 
formato delle date: ad esempio il "20 ottobre 
2006" sarà scritto 20/10/06 per la lingua italia- 
na, 10/20/06 per l'inglese americano. 



REQUISITI 



■g.i.wmiw.iwa 

SQL Server, .Net 
■ Framework2.0 



■j SQL Server 2005, Visual 
: Studio 2005 



0000 



GLOBALIZATION 
E LOCALIZATIOHI 

Globalizzazione e Localizzazione sono due facce 
della stessa medaglia e costituiscono la base del 
processo di internazionalizzazione delle applica- 
zioni. Nello specifico per globalizzazione si 
intende il processo con cui si prepara l'applica- 
zione a supportare diversi linguaggi. La localizza- 
zione si occupa invece della traduzione dell'ap- 
plicazione nella lingua desiderata. 



LOCALIZZIAMO 
I CONTENUTI 

Prima di entrare nel vivo, proviamo ad identifica- 
re alcuni dei principali elementi di un'applica- 
zione che potrebbero necessitare di una tradu- 
zione. 

• immagini: alcune immagini di un'applicazione 
potrebbero contenere del testo che dovrà esse- 
re localizzato; 

• testi statici: anche label, descrizioni testuali 
statiche, tooltip devono essere tradotte nelle 
lingue supportate dalla nostra applicazione; 



FACCIAMOLO 
CON WEBFORMS 

Costruiamo una scheda che legge i dettagli di un 
prodotto da una tabella di database e li visualiz- 
za in una pagina web. E' un semplice esempio 
che ci permette comunque di analizzare tutti gli 
aspetti della localizzazione. 
Creiamo come prima cosa il database e la tabella 
che conterrà le informazioni sui prodotti. 
Memorizziamo nome, descrizione, prezzo e data 
disponibilità. La chiave della tabella sarà compo- 
sta dalla coppia idProdotto -lingua 

CREATE TABLE [dbo].[Prodotti]( 

[idProdotto] [int] NOT NULL, 

[lingua] [char](5) COLLATE 

Latin l_General_CI_AS NOT NULL, 
[nome] [varchar](100) COLLATE 

Latin l_General_CI_AS NOT NULL, 
[descrizione] [text] COLLATE 

Latin l_General_CI_AS NOT NULL, 
[prezzo] [money] NOT NULL, 

[disponibile_dal] [datetime] NOT NULL, 

CONSTRAINT [PK_Prodotti] PRIMARY KEY CLUSTERED 



( 



[idProdotto] ASC, 



[lingua] ASC 
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)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY] 
) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY] 



Partial Class LanguageController 



Table - dbo.Prodotti CRI\MYS 1 Queryl.sql Summary 




itto lingua nome descrizione prezzo disponibile_dal 




1 en-US 


Product one Description for product one 


100,0000 10/10/2006 0.00.00 




1 it-IT 


Prodotto uno Descrizione prodotto uno 


100,0000 10/10/2006 0,00,00 




1 fr-FR 


Produitun Description pour le produi. . . 


100,0000 10/10/2006 0,00,00 




1 de-DE 


ProdukJtein Beschreibung f ur ProdukJt , , , 


100,0000 10/10/2006 0,00,00 


►* 


MAI MAI 


MAI MAI 


MAI MAI 



Fig. 1: La tabella prodotti 

Inseriamo quindi un prodotto di esempio 
Iniziamo il processo di globalizzazione prepa- 
rando la nostra applicazione affinché possa 
gestire le lingue. 
Creiamo innanzitutto uno "User Control" in cui 



Class 



iontrol 



HWeb User Control 



HH Class 
jJjWeb Configuration File 
g| Text File 
|j[] Data5et 
fp Mobile Web Form 
i^Crystal Report 
jj£ Mobile Web Configuration File 
■^Browser File 



Fig. 2: Il controller per la selezione della lingua 

inseriremo i pulsanti per cambiare le lingue. 
Clicchiamo con il tasto destro del mouse sul pro- 
getto e selezioniamo "Add New Item..." quindi 
"Web User Control" chiamiamo il file che stiamo 
creando "LanguageController.ascx". 
All'interno, inseriamo i pulsanti per cambiare la 
lingua attiva ed il codice necessario per notificar- 
ne il cambiamento all'applicazione. 

Il file LanguageController.ascx 



Inherits System. Web. Ul.UserControl 



Protected Sub ibn_ita_Click(ByVal sender As 
Object, ByVal e As System. Web. UI.ImageClickEventArgs) 

Handles ibn_ita. Click 



LanguageChange("it-IT") 



End Sub 



Protected Sub ibn_eng_Click(ByVal sender As 
Object, ByVal e As System. Web. UI.ImageClickEventArgs) 

Handles ibn_eng. Click 



LanguageChange("en-US") 



End Sub 



Protected Sub ibn_fra_Click( ByVal sender As 
Object, ByVal e As System. Web. UI.ImageClickEventArgs) 

Handles ibn_fra. Click 



LanguageChange("fr-FR") 



End Sub 



Protected Sub ibn_ger_Click(ByVal sender As 
Object, ByVal e As System. Web. UI.ImageClickEventArgs) 

Handles ibn_ger.Click 



LanguageChange("de-DE") 



End Sub 



Private Sub LanguageChange(ByVal culture As 

String) 

Response.Cookies("culture").value = 

culture 

Response.Cookies("culture").Expires 

= DateTime.Now.AddMonths(120) 

Response.Redirect(Request.UrlReferrer.ToString()) 

End Sub 
End Class 

Il controller non fa altro che scrivere un cookie 
con il nome della lingua selezionata e ricaricare 
la pagina. 

Utilizziamo quindi il Global asax per definire la 
lingua che stiamo utilizzando. Occorre importa- 
re due namespace: 




I FILE 
RESOURCES 

I file di risorsa (.resx) 
sono dei file che 
utilizzano XML per 
l'accesso ai dati e 
possono contenere 
testi, immagini, icone 
ed altri oggetti. 
Possono essere creati 
con Visual Studio 
oppure tramite 
un'utilità del 
framework chiamata 
resgen.exe o infine in 
modo programmatico 
utilizzando la classe 
ResourceWriter del 
namespace 
System. Resources. 
Sono molto utili per 
localizzare testi statici 
o immagini in base 
alla lingua selezionata. 



<%@ Control Language="VB" AutoEventWireup="false" 
CodeFile="l_anguageController.ascx.vb" 
Inherits="l_anguageController" %> 
<div style="white-space:nowrap;"> 
<asp:ImageButton ToolTip="Italiano" ID="ibn_ita" 

runat="server" ImageUrl="~/images/flag_ita.jpg" 

/>  
<asp:ImageButton ToolTip="English" ID="ibn_eng" 

runat="server" ImageUrl="~/images/flag_eng.jpg" 

/>  
<asp:ImageButton ToolTip="Francais" ID="ibn_fra" 

runat= "server" ImageUrl="~/images/fìag_fra.jpg" 

/>  
<asp:ImageButton ToolTip="Deutsch" ID="ibn_ger" 

runat= "server" ImageUrl="~/images/fìag_ger.jpg" 

/>   
</div> 

Il file LanguageController.ascx.es 



<%@ Import Namespace="System.Globalization" %> 
<%@ Import Namespace="System.Threading" %> 

Nel metodo Application _BeginRequest } leggiamo 
il cookie che è stato scritto; creiamo un oggetto 
Culturelnfo in base alla lingua selezionata e di 
conseguenza impostiamo la lingua del Thread 
corrente tramite CurrentClture e Current 
UlCulture. 

Utilizziamo il metodo Application_Begin 
Request perché questo viene eseguito ad ogni 
richiesta di pagina. Questo ci consente di rispar- 
miare codice in un sito che ha più pagine in 
quanto non dobbiamo inserire il codice per l'im- 
postazione della lingua in tutte le pagine. 

Sub Application_BeginRequest(ByVal sender As Object, 

ByVal e As EventArgs) 
Dim lang As Culturelnfo 
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If Request.Cookies("culture") Is Nothing Then 
Response.Cookies("culture").Value = 

"it-IT" 

End If 

Try 

lang = New 
CultureInfo(Request.Cookies("culture").Value) 
Catch 

lang = New CultureInfo("it-IT") 



End Try 



Thread.CurrentThread.CurrentCulture = lang 
Thread.CurrentThread.CurrentUICulture = lang 
End Sub 

In particolare la riga 

lang = New 

CultureInfo(Request.Cookies("culture").Value) 

crea l'oggetto Coulturelnfo in base alla lingua 
selezionata dall'utente. 
Mentre le seguenti righe: 

Thread.CurrentThread.CurrentCulture = lang 
Thread.CurrentThread.CurrentUICulture = lang 



"Default. aspx" nella cartella "LocWeb". 
Nella pagina è già presente il controllo che per- 
mette di cambiare la lingua corrente. 
Gli altri componenti sono: un'immagine 
"img_titolo" che conterrà il titolo della pagina, le 
Label con le descrizioni e alcuni TextBox che 
conterranno i dati letti dal database. 
Occupiamoci come prima cosa di localizzare le 
immagini. 

Creiamo una cartella chiamata "images" e, al suo 
interno, tante cartelle quante sono le lingue che 
intendiamo supportare, chiamandole con la sigla 
della lingua in questione. Nel nostro esempio ne 
creiamo quattro, nello specifico "it-IT", "en-US", 
"fr-FR" e "de-DE". 

A questo punto, creiamo le quattro immagini con 
il titolo nelle diverse lingue e salviamole nelle 
cartelle della lingua corrispondente con nome 
"header.gif". 

Fatto questo, associare le immagini corrette alla 
lingua è abbastanza semplice. 
Nel file Default.aspx.es dichiariamo una variabile 
globale 

Private lang As Culturelnfo 



assegnano l'oggetto Culturelnfo al Thread cor- 
rente. 

CurrentCulture specifica la cultura utilizzata per 
visualizzare informazioni e dati , viene usata per 
l'ordinamento delle stringhe, la visualizzazione 
di date, numeri e valute. 

CurrentUICulture permette di specificare la cul- 
tura per l'interfaccia utente (User Interface) e 
viene utilizzata quando si ricercano le informa- 
zioni nei file di risorsa. 

A questo punto, siamo pronti per creare la pagi- 
na che visualizza i prodotti. 

<%@ Page Language="VB" AutoEventWireup="false" 
CodeFile="Default.aspx.vb" Inherits="_Default" %> 
<%@ Register Src="l_anguageController.ascx" 
TagName="l_anguageController" TagPrefix="ucl" %> 
[omissis...] 
<table width = "100%"> 



<tr> 



<td colspan = "2"xasp:Image 

ID="img_titolo" runat= "server" /></td> 
<td align = "right" style="width: 184px" 

valign="top"> 
<ucl : LanguageController 
ID="LanguageControllerl" runat="server" /> 



</td> 



</tr> 



</table> 

Omettiamo parte del codice che potrete comun- 
que trovare nel CD allegato; il file in questione è 



che rappresenta la lingua selezionata e creiamo 
la procedura Page_PreInit 

Protected Sub Page_PreInit(ByVal sender As Object, 
ByVal e As System. EventArgs) Handles Me.Prelnit 
lang = Thread. CurrentThread. CurrentCulture 
'Immagine 
img_titolo.ImageUrl = "images/" & 

lang.Name & "/header.gif" 
End Sub 

La procedura non fa altro che leggere il valore 
di CurrentCulture e assegnare l'immagine cor- 
retta utilizzando la proprietà Name di lang. 
Per localizzare le etichette con le descrizioni ed 
altri elementi della pagina utilizziamo uno 
strumento molto comodo messo a disposizio- 
ne da .Net: i file di risorsa. 
Questi file conterranno le informazioni sugli 
elementi della pagina nelle varie lingue. 
Clicchiamo con il tasto destro del mouse sul 
progetto e selezioniamo "Add New Item...", 
quindi "ResourceFile". Chiamiamo il file 
"Resource.resx"; sarà il file per la lingua di 
default. 

Se apriamo Resource.resx in Visual Studio, 
questo si presenterà come una tabella. 
Notiamo due colonne: Name e Value. Nella 
prima metteremo i nomi delle risorse (a cui 
accederemo poi da codice per localizzare i 
contenuti), nella seconda inseriremo il valore 
della risorsa. 
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/ /App_GlobalRes...rce.de-DE.i 


esKJ^ 


LanguageController.ascx.vb 


Global, asax 


Hi] Strings ▼ J Add Resource 


' Remove Resource 
















Nanne 


a Value 




► 


lbl_descrizione 


Beschreibung| 




lbl_disponibile_dal 


Vorhanden von 




lbl_norme 


Name 


* 


lbl_prezzo 


Preis 


titolo_pagina 


Produce 















Conn.OpenQ 



Fig. 2: II file di risorse per la lingua tedesca 

Ripetiamo l'operazione per le altre quattro lin- 
gue avendo l'accortezza di nominare i file con 
"Resource.LINGUA.resx". Per il francese, il nome 
sarà, ad esempio, "Resource.fr-FR.resx". 
Trovate i file di risorsa utilizzati nel CD allegato. 
A questo punto, siamo in grado di localizzare i 
testi delle etichette. Per farlo, utilizziamo ancora 
una volta la procedura Page_PreInit vista prima. 
Inseriamo le seguenti righe in coda al codice già 
scritto. 

'Etichette 

lbl_nome.Text = Resource. lbl_nome 
lbl_descrizione.Text = Resource. lbl_descrizione 
IbLprezzo.Text = Resource. IbLprezzo 
lbl_disponibile_dal.Text = 

Resource. lbl_disponibile_dal 



'Titolo Pagina 



Page.Title = Resource. titolo_pagina 

Abbiamo utilizzato la sintassi nome_label.Text = 
Resource.nome_risorsa 

Così facendo, i testi delle Label ed il Title della 
pagina verranno letti dinamicamente dai file di 
risorsa in base alla lingua selezionata. 
Possiamo adesso occuparci di leggere i contenu- 
ti da database. 

Creiamo una classe "Prodotto" per mappare i 
campi della tabella prodotti. Importiamo due 
namespace: System.Data:SqlClient per l'accesso 
a SQL Server e System. Globalization per la loca- 
lizzazione. 

Imports Microsoft. VisualBasic 
Imports System. Data. SqlClient 
Imports System. Globalization 

Public Class Prodotto 

Private _nome As String 
Private _descrizione As String 
Private _prezzo As Doublé 
Private _disponibile_dal As DateTime 
Public Sub New(ByVal idProdotto As Integer, 
ByVal lang As Culturelnfo, ByVal Conn As 
SqlConnection) 
Try 



Dim Sql As String 



"SELECT " & . 



" nome, descrizione, 
prezzo, disponibile_dal" &_ 



" FROM Prodotti " & . 



" WHERE lingua = 

@lingua" & . 



" AND idProdotto = 

@idProdotto" 



Dim Comm As 
SqlCommand = New SqlCommand(Sql, Conn) 
Comm.Parameters.Add(New SqlParameter("@lingua", 

lang. Name)) 
Comm.Parameters.Add(New 

SqlParameter("@idProdotto", idProdotto)) 

Dim Areader As 

SqlDataReader = Comm.ExecuteReader() 

Try 
If 
Areader. Read Then 
Me._nome = Areader("nome") 
Me._descrizione = Areader("descrizione") 
Me._prezzo = Areader("prezzo") 
Me._disponibile_dal = Areader("disponibile_dal") 

End If 
Finally 
Areader.Close() 

End Try 
Finally 

Conn.Close() 
End Try 
End Sub 
Public ReadOnly Property nome() As String 

Get 

Return _nome 

End Get 

End Property 

Public ReadOnly Property descrizione() As 

String 

Get 

Return _descrizione 

End Get 

End Property 

Public ReadOnly Property prezzoQ As 



Doublé 



Get 



Return _prezzo 



End Get 



End Property 



Public ReadOnly Property disponibile_dal() As 

DateTime 



Get 



Return _disponibile_dal 



End Get 



End Property 




End Class 
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La classe ha un costruttore overloaded che legge 
dal database i dettagli del prodotto in base alla 
lingua e li salva in dei campi privati accessibili 
tramite delle proprietà di sola lettura. 
A questo punto, non ci resta che istanziare la 
classe nel Page_Load ed il gioco è fatto... 

Protected Sub Page_Load(ByVal sender As Object, 

ByVal e As System. EventArgs) Handles Me.Load 
If Not IsPostBack Then 
Dim idProdotto = 

Request.QueryString("idProdotto") 
If idProdotto = "" Then 

idProdotto = 1 
End If 

Try 

Dim Conn As 

SqlConnection = New 

SqlConnection(ConfigurationManager.ConnectionStrin 

gs("ConnectionString").ConnectionString) 

Dim P As Prodotto = 

New Prodotto(id Prodotto, lang, Conn) 

txt_nome.Text = P.nome 

txt_descrizione.Text = 

P.descrizione 
txt_prezzo.Text = 

P.prezzo.ToStringQ 



txt_disponibile_dal.Text 
= P.disponibile_dal.ToString() 
Catch ex As Exception 



Response.Redirect("ErrorPage.aspx") 



End Try 



End If 



End Sub 

Resta un'ultima cosa da fare. Date e numeri 
hanno modalità di visualizzazione diversa in 
base alla lingua, basti pensare al separatore dei 
decimali che può essere il punto oppure la vir- 
gola. Per visualizzare correttamente questi ulti- 
mi, creiamo una classe Globalizer che contiene 
due metodi FormatData e FormatNumero. 

Imports Microsoft. VisualBasic 



LE "CULTURE" 



Per poter specificare in modo 
univoco una cultura, è stato 
introdotto uno standard 
chiamato RFC 1766 che 
definisce codici univoci per 
ciascuna di esse. Questi sono 
formati da due parti separate 
da un trattino: la prima (in 
minuscolo) rappresenta la 
lingua, la seconda (in 



maiuscolo) specifica il paese. 
Ecco alcuni esempi 

- it-IT: italiano - Italia 

- en-GB: inglese - Regno unito 

- en-US: inglese - Stati Uniti 
Per una lista completa si può 
consultare l'MSDN 
http://msdn2.microsoft.com/en- 
us/library/system.globalization.cult 
ureinfo.aspx 



Imports System. Globalization 



Public Class Globalizer 



Public Shared Function FormatData(ByVal input 
As Object, ByVal lang As Culturelnfo) As String 



Try 



Dim tmp As DateTime = 
Convert.ToDateTime(input) 



Dim dtfi As 
DateTimeFormatlnfo = lang.DateTimeFormat 



Return 



tmp.ToString(dtfi) 



Catch ex As Exception 



Return "" 



End Try 



End Function 



Public Shared Function FormatNumero(ByVal 

input As Object, ByVal lang As Culturelnfo , ByVal 

decimali As Integer) As String 



Try 



Dim tmp As Doublé = 
Convert.ToDouble(input) 



Dim nfi As 



NumberFormatlnfo = lang.NumberFormat 



nfi.NumberDecimalDigits 



decimali 



Return tmp.ToString 

("N", nfi) 



Catch ex As Exception 



Return "" 



End Try 



End Function 



End Class 



A questo punto, ci basta utilizzare le due funzioni. 



Products 



Product one 



Description for product one 



Available from 



Fig. 4: La scheda prodotto 



txt_p rezzo. Text = Globalizer.FormatNumero(P.prezzo, 

lang, 2) 
txt_disponibile_dal.Text = 
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Globalizer.FormatData(P.disponibile_dal, lang) 
E lanciare l'applicazione! 



FACCIAMOLO 

coni winiFORMS 

Il processo di localizzazione è leggermente 
diverso per quanto riguarda WinForms. 
Creiamo un nuovo progetto Windows ed impo- 
stiamo il layout della form aggiungendo infine 
i controlli per la visualizzazione dei testi e della 
grafica: una PictureBox per il logo, le Label per 
le descrizione e le TextBox per i valori recupe- 
rati dal database. 



Oli , 'i r mi 

r** - j 

Elmmmliili- <l,il 



modificare i valori da localizzare. 
Selezioniamo come lingua "English (United 
States)" e cambiamo l'immagine del logo ed i 
testi della Label. Vedremo che viene creato in 
automatico il file "LocWin.en-US.resx". 
Ripetiamo l'operazione per le altre lingue che 
vogliamo impostare. 

A questo punto, abbiamo gestito le risorse sta- 
tiche; per quelle dinamiche possiamo utilizza- 
re i file "Globalizer.vb" e "Prodotto.vb" creati 
per l'applicazione web. 

Importiamoli nel progetto cliccando sul nome 
dello stesso con il tasto destro del mouse e 
selezionando "Add Existing Item". 
Nella form effettuiamo l'overload del costrut- 
tore di default per consentire alla form di esse- 
re caricata in base ad una specifica lingua. 
Il codice del file LocWin.bv è il seguente 



Launcher.vb [Design] LocWin.vb 





Fig. 5: Impostiamo il layout 



Fig. 7: Il nostro "launcher" 



Impostiamo quindi un attributo della form 
"Localizable = true ". 

Questo attributo permette a Visual Studio di 
generare i file di risorse in modo automatico. 
Per farlo, è sufficiente cambiare l'attributo 
"Language" nella lingua che vogliamo gestire e 



Properties ▼ ^ X 

LocWin System. Windows. Forrms. Form 



Mìì a / 



ForeColor 
FormBorderStyle 
HelpButton 
E Icori 
ImeMode 
IsMdiContainer 
KeyPreview 



| ControlText a 
Sizable 
False 

1=3 Clcon) 
NoControl 
False 
False 
I (Default) 



inglish (Caribbean) 

inglish (Ireland) 

inglish (Jarnaica) 

inglish (New Zealand) 

inglish (Republic of the Philippines) 

inglish (South Africa) 

inglish (Trinidad and Tobago) 

inglish (United Kingdom) 




Fig. 6: Selezioniamo la lingua da creare 



Imports System. Globalization 



Imports System.Threading 



Imports System. Data. SqlClient 



Public Class LocWin 



Dim lang As Culturelnfo 



Public Sub New(ByVal culture As String) 



Imposta Lingua(culture) 



InitializeComponent() 



Dim idProdotto As Integer = "1" 



Try 



Dim Conn As 



SqlConnection = New SqlConnection("Data 

Source=CRI\MYSQLEXPRESS;Initial 

Catalog=Internationalization;Integrated 

Security=True")Dim P As Prodotto = New 

Prodotto(idProdotto, lang, Conn) 



txt_nome.Text =P.nome 



txt_descrizione.Text = 

P.descrizione 
txt_p rezzo. Text = 
Globalizer.FormatNumero(P.prezzo, 2, lang) 
txt_disponibile_dal.Text= 
Globalizer.FormatData(P.disponibile_dal, lang) 
Catch ex As Exception 
MessageBox.Show("Error") 
End Try 
End Sub 
Private Sub Impostal_ingua(ByVal e As 
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Carmelo Scuderi è 



ingegnere 

informatico. 

Si occupa di sviluppo 

web-based in 

ambiente .Net per una 

software house di 

Milano. Gestisce un 

sito ricco di script e 

manuali per chi si 

affaccia al mondo 

della programmazione 

web 

fwww.morpheusweb.it) . 



String) 


lang = New Culturelnfo(c) 


Thread.CurrentThread.CurrentCulture = 


lang 




Thread.CurrentThread.CurrentUICulture 


= lang 




End Sub 


End Class 



La logica è la stessa che abbiamo utilizzato nella 
costruzione della pagina web. 
Manca un ultimo passo prima di completare l'appli- 
cazione. Creiamo una nuova WinForm "Launcher" 
che conterrà le bandierine rappresentanti le lingue a 
cui e sarà associato il codice per istanziare la form in 
una determinata lingua. 
Ecco il codice relativo al launcher 



Imports System. Globalization 



Imports System. Threading 



Public Class Launcher 



Private Sub btn_ita_Click(ByVal sender As 
System.Object, ByVal e As System. EventArgs) 
Handles btn_ita.ClickDim Iw As LocWin = New 
LocWin("it-IT") 



lw.ShowDialog() 



End Sub 



Private Sub btn_eng_Click(ByVal sender As 

System.Object, ByVal e As System. EventArgs) 

Handles btn_eng. Click Dim Iw As LocWin = New 

LocWin("en-US") 



lw.ShowDialog() 



End Sub 



Private Sub btn_fra_Click( ByVal sender As 
System.Object, ByVal e As System. EventArgs) 
Handles btn_fra. Click Dim Iw As LocWin = New 
LocWin("fr-FR") 



lw.ShowDialog() 



End Sub 



Private Sub btn_ted_Click( ByVal sender As 

System.Object, ByVal e As System. EventArgs) 

Handles btn_ted. Click Dim Iw As LocWin = New 

LocWin("de-DE") 



lw.ShowDialog() 



End Sub 



End Class 



GLI STRUMENTI MESSI 
W£ A DISPOSIZIONE DA .NET 



Nel framework .Net è presente il 

namespace System. Globalization 

destinato alla localizzazione 

delle informazioni. 

La classe principale è Culturelnfo 

che rappresenta una cultura 

specifica e ne definisce la 

visualizzazione di numeri, valute, 

date ed altro. 

La classe Regionlnfo fornisce. 



invece, informazioni sul paese. 
Altre classi utili sono 
NumberFormatlnfo per la 
formattazione dei numeri e 
DatetimeFormatlnfo per la 
formattazione delle date. 
Informazioni sul Namespace 
System. Globalization su: 
http://msdn2.microsoft.com/it- 
it/library/system.globalization.aspx 



Application 



Compile 

Debug 

References 

Resources 

5ettings 

5igning 

Spnirihf 



Configuration: |n/A 


v| 




Assembly narne: 


LocWin 


Application type: 


| Windows Application 


v 


Startup form: 





Platform: N/A 



Root namespace 



Icon: 



(Default Icon) 



jvj [ Assembla Inf" 



Enable application fraine 1 



Fig. 8: Cambiamo la form di avvio 

Al click su una bandiera corrisponde la creazione di 
una nuova istanza di LocWin a cui viene passata 
l'informazione sulla lingua da utilizzare. 
A questo punto, non ci resta che cambiare la form di 
partenza dell'applicazione. Per farlo, clicchiamo con 
il tasto destro del mouse sul progetto e selezioniamo 
"Properties". Dalla sezione "Application" impostia- 
mo "Launcher" come valore per l'opzione "Startup 
form". 
Abbiamo finito! Possiamo eseguire l'applicazione. 




PfoduUs 



Vtvntì>w pcu le [hcOj* ^ 



WKVKWWBWJ 



Fig. 9: il risultato finale 



CONCLUSIONI 

Con i nostri esempi abbiamo dimostrato come 
sia relativamente semplice realizzare delle 
applicazioni multilingua e abbiamo voluto sot- 
tolineare come il buon esito dell'operazione sia 
strettamente vincolato all'individuazione cor- 
retta, a priori, degli elementi che dobbiamo tra- 
durre. Una volta strutturata l'applicazione in 
modo che possa essere multilingua, ossia una 
volta globalizzata, localizzarla in 3 lingue piut- 
tosto che 4 o 5 non comporta un ulteriore cari- 
co di lavoro. Infatti, non sarà necessario scrivere 
nuovo codice; l'unica cosa da fare sarà tradurre 
i contenuti e inserirli nel database e nei file di 
risorse. 

Carmelo Scuderi 
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CREARE REPORT RTF 
CON ASP.NET 2.0 

LA CREAZIONE DI REPORTISTICA È SEMPRE STATA DEMANDATA A PACCHETTI ESTERNI. 
MA CON RTF SI PUÒ IMPLEMENTARE IN POCHI E SEMPLICI PASSI. SOPRATTUTTO SI PUÒ 
UTILIZZARE UN FORMATO UNIVERSALE ALMENO QUANTO PDF 




CI CD U WEB 

reportRTEzip 



n 




REQUISITI 



, — .NET Framework 

u 




La reportistica è alla base di tutte le applicazio- 
ni che manipolano dati, poiché consente di 
visualizzarli in maniera più semplice. Le tec- 
niche in questo ambito sono differenti e prevedono 
l'utilizzo di strumenti che automatizzano gran parte 
del lavoro, come Crystal Report, piuttosto che solu- 
zioni fatte in casa. Queste ultime hanno il vantaggio 
di essere più flessibili, garantire un'adattabilità più 
semplice ed un utilizzo dei formati che si preferisce. 
Lo scopo di questo articolo è quello di analizzare a 
fondo le caratteristiche di un sistema di reportistica, 
costruito da zero, che abbia come formato utilizzato 
RTF. 



File Edit View Favorites Tools Help 


Collegamenti g?\ ASPItalia.com j 


| Q Badi - _ - @ gj g) | P Seardi 


B EI 


| Address ||[) http:, //locali 


Report generato 


con 


template 


Nome: | 


Cognome: | | 


Genera report in formato RTF 


■ 







Fig. 1: Pagina di autenticazione 



PERCHE LA SCELTA DI RTF 

RTF (RichText Format) è un formato aperto, dispo- 
nibile su larga scala, le cui specifiche sono note, 
aperte e facilmente implementabili, poiché è intera- 
mente basato su testo in formato ASCII circondato 
da tag. 

Il vantaggio principale di RTF sta nell'immediatezza 
con il quale è possibile generare documenti dalla 
struttura anche molto complessa, poiché consiste di 
poche regole, che possono essere facilmente imple- 
mentate. Al pari di PDF, poi, RTF è un formato lar- 
gamente diffuso, praticamente su tutte le piattafor- 
me. L'idea alla base di questo articolo è dunque 
quella di creare un sistema in grado di generare i giu- 
sti tag RTF, così da avere alla fine un file che conten- 
ga esattamente l'output desiderato, contornato da 
una serie di informazioni di tipo stilistico, come la 



dimensione del font, il grassetto o l'italico, aggiunte 
in maniera del tutto naturale. 
Alla fine di questo articolo, dopo aver analizzato 
alcune tra le possibili soluzioni, si arriverà a quella 
più complessa, che prevede la creazione di una class 
library ad hoc per gestire la creazione di documenti 
in questo formato. 



LA VIA SEMPLICE: 
CON URI TEMPLATE 

La prima tipologia di soluzione, si basa per intero 
sulla creazione di un template, all'interno del quale 
inserire dei segnaposto, con la successiva sostituzio- 
ne di questi ultimi con i dati effettivamente recupe- 
rati dalla nostra fonte. 

Un approccio del genere risulta vincente, oltre che 
comodo, nel tipico sistema di fatturazione (o gestio- 
nale), dove la fattura è appunto contraddistinta dal- 
l'avere sempre lo stesso identico formato. 
Questa tecnica, poi, ha il vantaggio di rendere la 
creazione del template estremamente semplice, 
perché è sufficiente aprire Word, o un editor di RTF 
simile, per creare interfacce anche complesse, dal 
punto di vista grafico, che includano loghi o format- 
tazioni particolari. 

L'uso della classi della BCL del .NET Framework farà 
poi il resto, grazie alla possibilità di aprire il templa- 
te, provvedere alla sostituzione del testo e salvare il 
risultato finale, piuttosto che mostrarlo direttamen- 
te a video, consentendo all'utente anche di stampar- 
lo. 

In questo caso l'implementazione è abbastanza 
semplice e consiste nell'utilizzo della classe statica 
File, contenuta nel namespace System.IO. Questa 
classe ha un metodo, sempre statico, di nome 
ReadAllText, che è stato introdotto a partire dalla 
versione 2.0 e condensa al proprio interno l'utilizzo 
di uno StreamReader, l'oggetto utilizzato a partire 
dalla versione 1.0 per leggere informazioni da uno 
stream creato a partire da un file. 
Una volta caricato in memoria, si può procedere alla 
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sostituzione attraverso il metodo Replace di String, 
piuttosto che utilizzando una Regular Expression, 

se le tipologie di sostituzioni sono più complesse. 
Nel caso preso in esame si è optato per l'utilizzo di 
un formato per i segnaposti molto immediato, nella 
forma #segnaposto#, così da facilitare il compito sia 
in fase di creazione del template, che per quanto 
riguarda il codice, che diventa davvero semplice, 
come si può notare da quanto riportato in basso: 

// carico il template 
string template = 

File. ReadAIIText(Server. MapPathCtemplate.rtf"), 
System.Text.Encoding.GetEncoding("iso-8859-15")); 
// sostituzione del testo 
template = template. Replace("#firstname#", 

FirstNameBox.Text); 
template = template. Replace("#lastname#", 

LastNameBox.Text); 
// output a video 



Response.ClearQ; 



Response.ContentType="text/rft"; 



Response.AppendHeader("Content-Disposition", 

"attachment; filename=report.rtf"); 



Response.Write(template); 



Response.End(); 

L'esecuzione di una pagina con questo codice si tra- 
duce nell'avere un documento RTF, che sarà possibi- 
le aprire, ad esempio, direttamente con Word. 
Questo approccio è molto potente, anche per via 
della facilità con cui è possibile personalizzare l'out- 
put, ma mostra tutti i suoi limiti quando è necessa- 
rio estrarre quantità di informazioni maggiori, ad 
esempio prendendo come fonte dati una query 
effettuata su un database. È in questi casi, invece, 
che una soluzione più complessa mostra tutti i suoi 
vantaggi. 
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Fig. 2: II risultato 



IL FORMATO RTF 

Le specifiche RTF sono disponibili all'indirizzo 

http://support.microsoft.com/kb/q86999 /. 

Come già detto, è possibile implementare proprie 

soluzioni che utilizzino questo formato senza essere 



vincolati a royalty o limitazioni. 
Nel caso di una tabella, in realtà, il formato di RTF è 
tutt' altro che simile ad HTML, dove si ragiona con 
righe e colonne. 

Basta creare un semplice file con Word, come esem- 
pio, ed aprirlo con notepad per rendersene conto. 
Ripulito da tutto il codice che RTF aggiunge per la 
formattazione (in realtà molto verboso), il codice 
necessario a creare una tabella di due righe si riduce 
a questo: 

\trowd\trautofitl 

\intbl 

\cellxl 



\cellx2 



\cellx3 



{\rtlch\fcsl \af31507 \ltrch\fcsO 



Al\cell A2\cell A3\cell 



\row} 



{\trowd\trautofitl 



\intbl 



\cellxl 



\cellx2 



\cellx3} 



\trowd\trautofitl 



\intbl 



\cellxl 



\cellx2 



\cellx3 



{\rtlch\fcsl \af31507 \ltrch\fcsO 



Bl\cell B2\cell B3\cell 



\row} 



{\trowd\trautofitl 



\intbl 



\cellxl 



\cellx2 



\cellx3} 

La tabella è iniziata dal tag \trowd, che insieme a 
\trautofitl ha l'effetto di non richiedere la dichiara- 
zione delle dimensioni delle singole colonne, cosa 
che facilita di molto la creazione di una funzione 
generica in grado di generare una tabella qualsiasi a 
fronte del risultato di una query, contenuta all'inter- 
no di un oggetto di tipo DataTable. 
Il contenuto vero e proprio della riga della tabella è 
racchiuso all'interno delle parantesi {} che conten- 
gono i tag \cell, che rappresentano la fine del conte- 
nuto della cella stessa. 

Il tag \intbl indica invece che il contenuto che segue 
è un paragrafo di tipo tabellare, mentre le varie \cel- 
lxn servono ad indicare le colonne da aggiungere 
alla tabella. 

Il tag \row è praticamente il tag di chiusura di 
\trowd, con l'effetto di chiudere dunque la riga. 
Per ogni riga va ripetuto questo codice, così che in 
pratica la dimensione della tabella è indicata dalla 
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Do you want to open or save this file? 

[wfljh Name: report.rtf 

I -I Type: Rich Text Format 30,4 KB 

Fnom: localhost 



Open 



Save 



Cancei 



While files fnom the Internet can be useful. some files can potentially 
harm your computer. If you do not trust the sounce. do not open or 
save this file. What'sthe risk? 



Fig. 3: I controlli di sistema 

tipologia di informazioni contenute all'interno dei 
tag generati. La creazione dunque di una classe in 
grado di generare output direttamente in formato 
RTF può partire isolando le casistiche più importan- 
ti. Ad esempio, un testo in grassetto è incluso all'in- 
terno di una sequenza {\b testo }, mentre il corsivo è 
semplicemente {\i testo }. Basta cominciare ad 
implementare un po' di metodi che scrivano all'in- 
terno di uno StringBuilder, se invocati, il contenuto 
passato come argomento. E tenere presente, allo 
stesso tempo, che il documento deve avere le infor- 
mazioni sul formato, subito dopo il tag \rtfl, che 
serve per specificare al programma che andrà ad 
aprire il documento generato che si tratta effettiva- 
mente di un documento RTF. Nel caso specifico, la 
struttura base del documento è fatta così: 

{\rtfl\ansi 

\marglll34\margrll34\margtl418\margbll34 
Contento del file 

y~ 

La seconda riga imposta i margini del documento, 
facendo in modo che nel formato A4 vengano 
rispettati correttamente. 

Partendo da queste funzionalità di base, non ci resta 
che implementare il codice legato alla creazione 
della tabella, che deve consistere di un po' di cicli, 
come in questo esempio: 

// ciclo su righe per estrarre il contenuto 
for (int k = 0; k < dt.Rows.Count; k++) 

{ 

// stili 

text.Append("\\trowd\\trautofitl\\intbl"); 

for (int j = 0; j < dt.Columns.Count; j++) 
text.Append("\\cellx" + (j+1)); 
// contenuto 
text.Append("{"); 
for (int j = 0; j < dt.Columns.Count; j++) 

{ 
text.Append(dt.Rows[k][j].ToString()); 

text.Append("\\cell "); 

} 

text.Append("}"); 
// stili 2 



text.Append("{"); 


for (int j = 0; j < dt.Columns.Count; j++) 


text.Append("\\cellx" + (j+1)); 


text.Append("\\row }"); 


} 



Si è scelto di utilizzare una DataTable perché garan- 
tisce che i dati contenuti all'interno possano essere 
prelevati da qualsiasi fonte, da un database o anche 
da un oggetto custom, garantendo una certa omo- 
geneità di funzionamento, grazie al fatto che è un 
oggetto in grado di contenere qualsiasi tipologia di 
informazione al proprio interno. Il risultato è quello 
di avere una tabella generata in maniera molto sem- 
plice, a partire da qualsiasi query. 



L'INTESTAZIONE 
DELLA TABELLA 

Per l'intestazione si è scelto di utilizzare sempre una 
cella normale, con l'aggiunta del tag necessario a 
generare il grassetto. Il ciclo in questo caso viene 
effettuato sulle colonne, che attraverso la proprietà 
Columns la DataTable espone, con tanto di nome 
delle stesse. Questa caratteristica rende possibile 
l'aggiunta di un'intestazione generica rispetto al 
contenuto vero e proprio della DataTable, così da 
rendere praticamente universale il codice prodotto. 
La parte prima e dopo il codice che segue è in realtà 
praticamente identica a quanto specificato per una 
normale cella, quello che davvero cambia è l'estra- 
zione dei nomi delle colonne: 



// nome delle colonne 


text.Append("{"); 


for (int j = 0; j < dt.Columns.Count; 


J++) 


{ 


this.WriteBold(dt.Columns[j].Columnl\lame); 


text.Append("\\cell "); 


} 


text.Append("}"); 



Il risultato è quello di avere ora i nomi delle colonne, 
a prescindere dalla fonte dati, riportate in cima alla 
tabella, come riferimento per i dati contenuti. 




URI VIA ALTERNATIVA PER CHI USA VISUAL 
WEB DEVELOPER 2005 EXPRESS 



L'utilizzo di VWD 2005 Express 
vincola al non poter utilizzare un 
progetto e quindi nemmeno una 
class library. 

Dopo aver scaricato il codice 
associato a questo articolo è 
sufficiente prelevare il file 



RtfWriter.es e copiarlo nella 
directory /App Code/, sotto la 
root del sito. In questo modo la 
classe sarà compilata in 
automatico, insieme al sito web, 
e potrà essere utilizzata nella 
pagina senza alcun limite. 
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F(£. 4: Una tabella RTF 



AGGIUNGERE I BORDI 
ALLE TABELLE 

Perché il nostro sistema di reportistica possa dirsi 
quanto meno in grado di reggere altri sistemi analo- 
ghi, è necessario aggiungere un bordo alle celle. 
Poiché in RTF in realtà una tabella è essenzialmente 
un paragrafo speciale, i tag da aggiungere per avere 
come output una tabella sono in realtà molto più 
complessi, dal punto di vista semantico, di quanto 
ad esempio preveda l'HTML, che consente di speci- 
ficare la proprietà di questo tipo direttamente sulla 
tabella. In RTF, invece, il bordo va impostato su ogni 
singola cella, con l'effetto che praticamente è neces- 
sario farlo all'interno del ciclo, così da avere effetto 
su tutte le celle della tabella. 

I bordi poi possono essere impostati in maniera 
indipendente l'uno dagli altri, così che il codice 
necessario per ogni singola cella diventa il seguente: 

\clbrdrt\brdrs\brdrwlO 

\clbrdrl\brdrs\brdrwlO 

\clbrdrb\brdrs\brdrwlO 
\clbrdrr\brdrs\brdrwlO 
\cellxl 

Come si può notare è necessario anteporre la defini- 
zione dello stile prima della dichiarazione stessa 
della cella, così che poi quando viene effettivamente 
riempita la cella, possa essere applicato. 
È interessante notare, poi, come nel blocco di tag 
appena postato, il primo definisca il bordo superio- 
re, il secondo quello di sinistra, poi quello inferiore 
ed infine quello di destra. Il tag \brdrwlO indica la 
dimensione, che è fissata in 1 twpis. 

II twips è un'unita di misura particolare, che vale 
0,05 pollici, cioè 1,125 millimetri, ed è utilizzata in 
tutti i casi in cui sia necessario specificare una 
dimensione. 

È anche possibile utilizzare misure decimali, ad 
esempio 05 avrebbe avuto l'effetto di aggiungere un 
bordo di 0,5 twips di spessore. 
L'operazione va ripetuta, all'interno del ciclo, su 



ogni singola cella, per ogni riga. 
È utile sottolineare che il bordo della tabella è rego- 
lato da altri tag, che vanno specificati prima delle 
definizione delle stessa: 

\trbrdrt\brdrs\brdrwlO 

\trbrdrl\brdrs\brdrwlO 

\trbrdrb\brdrs\brdrwlO 



\trbrdrr\brdrs\brdrwlO 



\trbrdrh\brdrs\brdrwlO 



\trbrdrv\brdrs\brdrwlO 

Gli ultimo due indicano rispettivamente il bordo 
orizzontale e verticale della tabella. 
Messo tutto insieme, isolando il codice che genera le 
definizioni in un metodo a parte, così da evitare di 
ripetere inutilmente codice superfluo, il ciclo diven- 
ta: 

for (int k = 0; k < dt.Rows.Count; k++) 

{ 

// stili 

text.Append("\\trowd\\trautofitl\\intbl"); 

GenerateCellAttributes(dt); 

// contenuto 

text.Append("{"); 

for (int j = 0; j < dt.Columns.Count; j++) 

{ 
text.Append(dt.Rows[k][j].ToString()); 

text.Append("\\cell "); 



text.Append("}"); 
// stili 2 

text.Append("{"); 
text.Append("\\trowd\\trautofitl\\intbl"); 

GenerateCellAttributes(dt); 

text.Append("\\row }"); 



Dove il metodo GenerateCellAttributes, invece, con- 
tiene le definizioni degli stili, praticamente solo rela- 
tivi ai bordi, in questo modo: 



private void GenerateCellAttributes(DataTable dt) 


{ 


for (int j = 0; j < dt.Columns.Count; j++) 


{ 


text.Append("\\clbrdrt\\brdrs\\brdrwlO"); 


text.Append("\\clbrdrl\\brdrs\\brdrwlO"); 


text.Append("\\clbrdrb\\brdrs\\brdrwlO"); 


text.Append("\\clbrdrr\\brdrs\\brdrwlO"); 


text.Append("\\cellx" + (j + 1)); 


} 


} 



A questo punto il generatore di report è pronto, non 
ci resta che creare una pagina in grado di renderne 
possibile l'interrogazione. 
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TUTTO INSIEME 

Ed ora la parte più semplice, poiché mettere 
insieme il tutto è davvero il compito meno impe- 
gnativo. Una volta generato l'assembly, a partire 
dalla compilazione delle class library, è sufficien- 
te creare una nuova pagina, dopo aver aggiunto 
un riferimento all'interno del sito web, così che 
l'assembly con la nostra classe per generare RTF 
possa essere referenziata ed utilizzata. Per prima 
cosa è dunque necessario estrarre i dati che 
saranno visualizzati. Per farlo si è scelto il data- 
base pubs di SQL Server, creando un report degli 
autori presenti, con questo codice: 

// estrazione dei dati 

SqlDataAdapter da = new SqlDataAdapterfSELECT 
aujname as [Last Name], au_fname as [First Name], 
Address, City, ZIP, Phone FROM Authors", 
ConfigurationManager.ConnectionStrings["pubs"].Connect 

ionString); 
DataTable dt = new DataTable(); 
da.Fill(dt); 

Creata la DataTable e popolata con i dati, è 
necessario provvedere alla creazione del report 
vero e proprio. È utile sottolineare che la query è 
stata strutturata in maniera tale che i nomi dei 
campi vengano mostrati con un nome più 
descrittivo e migliore da visualizzare nel report 
stesso, utilizzando gli alias sulle colonne. A que- 
sto punto va creata l'istanza della classe 
RtfWriter, che contiene il nostro motore di gene- 
razione del report: 

// Generazione del report 

RtfWriter rtf = new RtfWriter("report.rtf"); 

E successivamente vanno aggiunti un po' di para- 
grafi, prima della tabella vera e propria, così: 

// intestazione 

rtf.WriteParagraphStartQ; 

rtf.WriteBold("Report degli autori"); 
rtf.WriteParagraphEnd(); 
rtf . Write E m pty Pa ra g ra p h ( ) ; 
rtf.WriteParagraph("Generato " + 

DateTime.Now.ToLongDateStringO + " alle ore " + 
DateTime.Now.ToLongTimeString(), 0); 
rtf . Write E m pty Pa ra g ra p h ( ) ; 

Infine, non resta che passare la DataTable al metodo 
WriteTableFromDataTable, che genererà il codice 
RTF, attraverso il codice che si è analizzato nei para- 
grafi precedenti: 

// converto la DataTable in RTF 
rtf.WriteTableFromDataTable(dt); 



L'ultimo passaggio consiste nello scrivere a video il 
risultato, dopo aver impostato l'header Content- 
Disposition, in modo che proponga al client di sca- 
ricare il file generato. 

// scrivo a video 

Response.Clear(); 

Response.ContentType="text/rft"; 

Response.AppendHeader("Content-Disposition", 

"attachment; filename=" + rtf.DocumentName); 
Response.Write(rtf.GenerateDocument()); 



Response.EndQ; 



CONCLUSIONI 

Lungi dall'essere completa al 100%, questa classe 
ha però diversi vantaggi e rappresenta una valida 
base di partenza per la creazione di moduli di 
reportistica anche più complessi di quello ogget- 
to dell'esempio. 

Il vantaggio principale che offre è senza dubbio 
quello di consentire una facile creazione di tabel- 
le, oltre alla possibilità di essere utilizzato anche 
in altri ambiti, come ad esempio in presenza di 
Windows Service o WinForms, dato che la parte 
di generazione, che nel nostro esempio abbiamo 
utilizzato in una pagina web, può essere tran- 
quillamente inserita in altri contesti. 

Daniele Bochicchio 



^par 


Specifica la fine del paragrafo. 


\pard 


Specifica la fine del paragrafo e di qualsiasi altro 
stile specificato. 


Mine 


Va a capo senza interrompere il paragrafo corrente. 


\ql 


Allinea il testo a sinistra. 


\qr 


Allinea il testo a destra. 


\qj 


Allinea il testo giustificandolo. 


\qc 


Allinea il testo al centro. 


\b 


Imposta il grassetto per il testo specificato. 


Vi 


Imposta l'italico per il testo specificato. 


\ul 


Imposta la sottolineatura del testo. 


\super 


Inserisce il testo come apice. 


Vfin 


Imposta il rientro della prima linea del paragrafo. 


Min 


Imposta il margine del rientro a sinistra del paragrafo. 


\rin 


Imposta il margine del rientro a destra del paragrafo. 


\page 


Inserisce un salto pagina. 


\paperwn 


In n va specificato la larghezza della pagina. 


\paperhn 


In n va specificata l'altezza della pagina. 


\margln 


In n va specificato il margine sinistro della pagina. 


\margrn 


In n va specificato il margine destro della pagina. 


\margtn 


In n va specificato il margine superiore della pagina. 


\margbn 


In n va specificato il margine inferiore della pagina. 


Mandscape 


Imposta la pagina come orizzontale. 


Aportrait 


Imposta la pagina come verticale. 


Tabella: 1 principali tag di RTF , 
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TENERE LA MEMORIA 
SOnO CONTROLLO 

CONCLUDIAMO IL VIAGGIO NEL PAESE DEGLI SMART POINTERS, ANALIZZANDO QUELLI 
PIÙ AVANZATI OFFERTI DALLA LIBRERIA BOOST LA CONOSCENZA DI QUESTI ELEMENTI 
È UN OBBLIGO PER OGNI PROGRAMMATORE C++ 




REQUISITI 



I , i Buona conoscenza 
del C++ 




Benvenuti al secondo appuntamento col 
mondo degli smart pointers. Chi di voi si 
fosse perso il primo (male!), dovrebbe 
seriamente pensare di rimettersi in carreggiata 
provando a seguire questo. "Perché è così fonda- 
mentale?" direte voi "io ho programmato per anni 
senza sapere cosa significhi la parola smart poin- 
ter, e non ho mai avuto problemi!". Davvero? 
Non vi è mai successo che la vostra applicazione si 
mettesse improvvisamente, inesorabilmente a 
ingurgitare risorse, fino a rallentare ed eventual- 
mente mandare in crisi il sistema? 
Non vi è mai successo che nel bel mezzo del pro- 
gramma comparisse ai vostri clienti una simpati- 
ca schermata di dump reporting, in seguito ad un 
errore di segmentation fault, o access violation? 
Non avete mai pensato che le eccezioni causino 
più problemi di quanti non ne risolvano, quando 
utilizzandole il programma va incontro a strani 
effetti collaterali? 

Tutti questi problemi hanno una sola causa: state 
continuando a gestire la memoria dinamica 
manualmente. 
Quando dichiarate un oggetto, come in: 

Musica canzone; 

non dovete preoccuparvi di rimuoverlo, perché 
sapete che ci penserà l'applicazione al momento 
dell'uscita dal blocco attuale (per dirla meglio: 
dall'area di visibilità della variabile). Ma ogni volta 
che utilizzate una chiamata all'operatore new, 
avete l'obbligo di richiamare, prima della fine del- 
l'applicazione, la corrispettiva istruzione delete. E 
qui cominciano i problemi: 

• Se vi dimenticate di deallocare un oggetto crea- 
to con new, causate un memory Leak: il vostro 
oggetto rimane in memoria sotto forma di inu- 
tile spazzatura, occupando spazio inutilmente. 

• D'altro canto, se vi sbarazzate troppo presto 
della risorsa (ciò che in gergo viene detto pre- 
mature free) lasciate dei puntatori in giro per la 



vostra applicazione che fanno ancora riferi- 
mento ad un'area già distrutta. Questi puntato- 
ri prendono il nome di dangling pointers, e 
sono una delle cause principali del mal di testa 
cronico che affligge il programmatore C++ 
medio. 

• Se accedete ad un'area di memoria scorretta 
(perché non avete ancora inizializzato l'oggetto 
con new, o perché state usando un dangling 
pointer), potete causare ogni tipo di danno, dal 
segmentation fault in su. 

• Se, poi, distruggete una risorsa già distrutta, 
richiamando due volte di seguito l'operatore 
delete sullo stesso puntatore, avete praticamen- 
te la certezza di aver come minimo mandato in 
crash l'applicazione. Potete vantarvi di aver 
compiuto con successo un doublé free. 

La soluzione a questi problemi esiste, e non è 
quella di mettersi a spulciare con un debugger 
per ore il proprio codice, nella speranza di 
capire in quale delle miriadi di oggetti usati 
dalla vostra applicazione si sia generato un 
dangling pointer. La soluzione è: fate gestire la 
memoria dinamica automaticamente alla 
macchina. Ci sono diversi sistemi per conse- 
guire questo risultato: nel precedente articolo 
abbiamo cominciato a fare la conoscenza con 
le fondamentali classi note come smart poin- 
ter. Si tratta di classi proxy, ovvero oggetti che 
incapsulano un puntatore, ne imitano il com- 
portamento e richiamano l'operatore delete al 
momento della loro distruzione. In questo 
modo gli smart pointer possono essere allocati 
staticamente sullo stack, come l'oggetto 
Musica che abbiamo visto all'inizio, e contem- 
poraneamente garantiscono la deallocazione 
automatica e sicura delle risorse che detengo- 
no in memoria dinamica. Un esempio vale più 
di mille parole: 

#include <memory> 
#include <iostream> 
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int main() { 



//creiamo la risorsa con new 



std: :auto_ptr<string> stringa(new 

string("Ciao mondo!"); 
//... ma non la distruggiamo! Ci pensa 

l'applicazione. 
} //qui l'auto_ptr "stringa" viene distrutto, e con lui 
la risorsa "Ciao mondo". 

Nel primo appuntamento di questa serie abbia- 
mo cominciato a vedere due smart pointer fon- 
damentali: boost::scoped_ptr e std::auto_ptr. 
Abbiamo cominciato a scoprire dei vantaggi 
fondamentali offerti da queste strutture, ma 
anche molte limitazioni, in particolare: 

• Lo smart pointer boost::scoped_ptr è semplice 
e comprensibile, ma non è copiabile e pertan- 
to non può uscire dall'area di visibilità in cui è 
stato dichiarato. 

• Lo smart pointer std::auto_ptr può essere uti- 
lizzato per passare risorse da una funzione 
all'altra (attraverso un modello chiamato 
source/sink), ma ha uno strano sistema chia- 
mato copia distruttiva che sembra creato 
apposta per rendere le cose complicate. 

Quest'ultimo punto ha segnato la chiusura del 
nostro precedente appuntamento, ed è effetti- 
vamente importante e complesso. Nel prossimo 
paragrafo riprenderemo l'illustrazione del mec- 
canismo di copia distruttiva, delle limitazioni di 
auto_ptr, e vedremo come superarle. 



PROBLEMI 

di conioivisioniE 

L'amara verità alla quale il programmatore C++ 
deve presto rassegnarsi, è che l'auto_ptr fornito 
dalla libreria standard non può essere usato alla 
leggera, e in molti casi (qualcuno direbbe: in 
troppi casi) semplicemente non funziona. Il 
problema fondamentale è la copia distruttiva, 
cioè il meccanismo per cui copiando un oggetto 
A in uno B, il possesso della risorsa passa a B, 
mentre A viene messo a terra. Esempio: 

#include <iostream> 
#include <string> 
#include <memory> 
using namespace std; 
int main() 

{ 

//creiamo un nuovo auto_ptr<string> 

chiamato "originale" 
auto_ptr<string> originale(new 

string("Ciao, mondo!")); 



//creiamo un auto_ptr<string> che copia 

l'originale 
auto_ptr<string> copia(originale); 

//ora "copia" possiede la stringa 
if (copia. get()) 

cout << "La copia e' valida: " << 
*copia << endl; 
//ma "originale" è messo a terra! 



if (!originale.get()) 



cout << "L'originale e' stato 

messo a terra !\n" 



Risultato: 



La copia e' valida: Ciao mondo! 



L'originale e' stato messo a terra! 

Per capire perché il comitato di standardizza- 
zione ha scelto un sistema così strano per gesti- 
re auto_ptr, ci si potrebbe chiedere cosa acca- 
drebbe se due copie identiche di auto_ptr si tro- 
vassero a condividere la stessa risorsa?. Ma al 
momento della loro distruzione il sistema 
andrebbe incontro a un doublé free. 
La copia distruttiva, però, ha un grave problema 
di fondo: modifica la semantica standard del 
linguaggio per la quale ci si aspetterebbe che un 
dato e la sua copia siano identici. 
Detto in altre parole: usando auto_ptr occorre 
sempre stare attenti che la copia che stiamo uti- 
lizzando non sia quella di partenza, ormai 
"messa a terra". Ciò ha almeno un'implicazione 
molto pesante: dal momento che i contenitori 
standard non danno alcuna importanza all'or- 
dine con cui effettuano le copie, non è possibile 
usarli per contenere oggetti auto_ptr. 
Vale la pena di notare che questi problemi afflig- 
gono non solo gli auto_ptr, ma anche le classi 
composte da uno o più membri auto_ptr. 
Quest'esempio chiarisce la situazione: 

#include <iostream> 
#include <vector> 
#include <memory> 
#include <string> 
using namespace std; 
struct Musica 

{ 

string titolo; 

Musica(const string& _titolo) : titolo(_titolo) 

{}]_ 

}} 

class LettoreStereo 

{ 

auto_ptr<Musica> musica; 
public: 




BOOST! 

La libreria boost 
(www.boost.org) è un 
riferimento essenziale 
per i programmatori 
C++ più smaliziati, dal 
momento che fornisce 
molte funzionalità 
avanzate e colma 
alcune lacune del 
linguaggio. 



http://www.ioprogrammo.it 



Gennaio 2007/ 97 ► 



096-102 28-11-2006 9:56 Pagina 98 



SISTEMA T H Gestione della memoria 




Letto reste reo ( co nst stringa titolo) 



musica(auto_ptr< Musica >(new 

Musica(titolo))) {} 



void Play() { 



if (musica->titolo.empty()) 



co ut << "Lettore 

vuoto."; 



else 



cout << "Sto suonando: 
" << musica->titolo; 



>; 



int main() 



{ 



vector<LettoreStereo> jukeBox; 



jukeBox.push_back(LettoreStereo("Bach.MP3")); 



jukeBox[0].PIay(); 



> 



funzionano con un valore const, gli auto_ptr 
non possono essere inseriti nei contenitori 
standard. E la stessa cosa vale anche per le clas- 
si come LettoreStereo, che hanno almeno un 
membro auto_ptr, e non definiscono esplicita- 
mente un costruttore per copia (secondo le 
regole del C++, infatti, queste classi assumono 
implicitamente un costruttore per copia non- 
const). 

Se, d'altro canto, utilizzassimo un compilatore 
non aderente allo standard in questa direttiva, il 
comportamento sarebbe indefinito: Visual C++ 
6.0, ad esempio, compila senza il minimo war- 
ning restituendo (per questa volta) il messaggio 
corretto. Altri compilatori, soprattutto in segui- 
to ad operazioni di sorting, stampano a video 
"Lettore vuoto", facendo capire che è sopravvis- 
suta la copia sbagliata. 



^ 



Musica 



titolo 



autore 



formato 



Qui si riprende parzialmente una situazione 
illustrata nel primo articolo, nel quale Musica 
era una classe base, e LettoreStereo doveva usare 
un auto_ptr per preservare il polimorfismo. 
Compilare e/o eseguire questo programmino è 
interessante anche per valutare la qualità dei 
vostri strumenti di lavoro. Un compilatore ade- 
rente allo standard deve generare un errore, con 
un messaggio simile a questo: 

Error in line: " 

jukeBox. push_back(LettoreStereo("Bach.MP3")); " 
No matching function cali to 

"LettoreStereo(const Letto reStereo&)" 
Candidates are: "LettoreStereo(LettoreStereo&)" 

È il risultato di un trucco che ha usato il comita- 
to di standardizzazione nello stendere i requisi- 
ti di una classe auto_ptr, stabilendo che il 
costruttore per copia di auto_ptr debba essere 
dichiarato con un parametro non-const. Dato 
che gli algoritmi di inserimento nei contenitori 



RefCountinyptr 




data 



countei 



RefCountingptr 



data 



countei 



RefCountingptr 



data 



con nte r 




Fig. 1: Tre smart pointer a reference counting condividono la stessa risorsa 



REFERENCE COUNTING 

Se gli smart pointer fossero persone, quelli che 
abbiamo visto finora non sarebbero tanto sim- 
patici. Scoped_ptr è un avaro che non vuol divi- 
dere la sua risorsa con nessuno, e auto_ptr è un 
ladro pronto a rubarla ai suoi stessi simili. 
Questi comportamenti chiusi ed egoisti rifletto- 
no una consapevole scelta di progettazione, 
cioè quella di far funzionare queste classi senza 
che esse debbano "mettersi d'accordo" fra loro. 
Quando più smart pointer devono condividere 
la stessa risorsa, però, la politica autarchica non 
regge più, e queste classi devono necessaria- 
mente trovare un modo per comunicare, o 
quantomeno per far sapere alle altre che esisto- 
no. I modi in cui si può perseguire questo fine 
sono diversi e hanno molte varianti: qui ci occu- 
peremo di analizzare alcune tecniche di refe- 
rence counting, rimandando ai testi in biblio- 
grafia per gli altri sistemi (il settimo capitolo del 
testo di Alexandrescu offre una panoramica 
molto vasta sull'argomento). 
Come illustrato in figura 1, nel sistema di refe- 
rence counting gli smart pointer utilizzano un 
contatore per sapere quanti loro simili stanno 
accedendo alla risorsa, in questo modo: 

• All'acquisizione della risorsa (tramite costrut- 
tore, o reset), viene creato un contatore. 

• Alla copia (tramite costruttore per copia o 
assegnamento) il contatore viene incremen- 
tato. 

• Alla distruzione il contatore viene decremen- 
tato, e se questo arriva a zero la risorsa viene 
distrutta. 
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Così facendo, si ottiene uno smart pointer "uni- 
versale" che funziona senza problemi nella 
maggior parte dei casi (le eccezioni esistono, e le 
vedremo verso la fine dell'articolo. Abbiate 
pazienza.). 

• Shared_ptr 

La libreria boost (sempre lei!) offre uno smart 
pointer a reference counting di grande versati- 
lità e semplicità d'uso. La classe è tanto utile e 
ben progettata che è stata presa a modello per lo 
smart pointer omonimo nel TRI, ed è pratica- 
mente certo che sarà parte integrante dello 
standard della nuova versione del C++ (C++0x), 
con il nome di trl::shared_ptr (molti libri e 
guide usano già questa denominazione. Io pre- 
ferisco boost: :shared_ptr, dal momento che per 
molti compilatori il TRI è ancora "qualcosa che 
si mangia"). 

• Funzioni per il conteggio 

A questo punto dovrei mostrarvi l'interfaccia di 
boost::shared_ptr, ma sarebbe uno spreco di 
spazio, perché ricalca la struttura già presentata 
in scoped_ptr (togliendo il discorso su non- 
copyable, ovviamente), con l'aggiunta di un paio 
di funzioni dedicate al contatore. 

• long use_count() const: restituisce l'indice del 
contatore. 

• bool uniquef) const: restituisce true se lo 
smart_pointer è l'unico a detenere la risorsa 
(cioè se use_count() == 1, anche se è solita- 
mente più rapida dell'accesso a use_count). 

Ecco un esempio di queste funzioni in azione: 

#include <iostream> 

#include <string> 

#include <boost/shared_ptr.hpp> 

using namespace std; 

using namespace boost; 

struct Musica 

{ 

string titolo; 



Musica(const stringa _titolo) 



titolo(_titolo) 

{}; 



copia(musica); 


cout << "Ci sono " << 

musica. use_count() 


<< " riferimenti a " << 
musica->titolo << endl; 


}//qui la copia viene distrutta 


if (musica. unique()) 


cout << "E' rimasto un solo 

riferimento!" << endl; 


} 



Risultato dell'esecuzione: 



Ci sono 2 riferimenti a Bach.mp3 



E' rimasto un solo riferimento! 



Bach.Mp3 e' stata distrutta! 

Va notato che il funzionamento dello smart 
pointer è completamente automatico, perciò 
non si è mai realmente interessati al numero o 
all'unicità dei riferimenti, se non per ragioni di 
pura curiosità o di debug (oppure se state 
creando un sistema Copy On Write, nel qual caso 
la funzione uniqueQ è effettivamente utile). 

• Funzioni per il pointer_casting 

Funzioni più utili sono quelle relative al casting 
del puntatore, che è bene comprendere a fondo. 
Proviamo a ipotizzare di avere uno 
shared_ptr<const Musica>, e di volere invece 
ottenere a tutti i costi uno shared_ptr<Musica>, 
da passare ad una funzione. 

void RinominaMusica(const shared_ptr<Musica>& 

musica, const string& nuovoTitolo) { 
musica->titolo = nuovoTitolo; 

} 

int main() 

{ 

shared_ptr<const Musica> musica(new 

Musica("Bach.MP3")); 

//nota: questa "soluzione" è sbagliata! 
shared_ptr< Musica > 
musicaNonConst(const_cast<Musica*>(musica.get()) 

)±_ 

RinominaMusica(musicaNonConst / 

"Beethoven. MP3"); 
cout << musica. use_count() << endl; // 




USARE BOOST 

La libreria boost non è 
famosa per la 
semplicità 
d'installazione. 
Fortunatamente, le 
definizioni degli smart 
pointers non 
richiedono alcuna 
installazione: è 
sufficiente impostare 
l'IDE (o le variabili 
d'ambiente) inserendo 
fra le directory di 
inclusione la directory 
radice in cui si è 
scaricato boost. 



^Musica() {cout << titolo << " e' stata 

distrutta!" << endl;} 



1!!! 



> 



int main() 



{ 



shared_ptr<Musica> musica(new 

Musica("Bach.MP3")); 



{//sotto-scope 



shared_ptr< Musica > 



Nel codice qui sopra ho provato a costruire un 
nuovo shared_ptr<Musica> prendendo il punta- 
tore di musica tramite una chiamata al metodo 
get(), e sbarazzandomi del suo vincolo di 
costanza per mezzo di un constjcast. La cosa 
sembra aver senso, e compila pure, ma va in 
crash alla fine deir esecuzione. Si può intuirne la 
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^ 



ragione, osservando che la chiamata 
musica.usejcountO restituisce 1: essendo due 
oggetti costruiti separatamente, musicaNon 
Const e musica hanno due contatori distinti, e 
quindi entrambi i distruttori deallocano la risor- 
sa, provocando così un doublé free. Per supera- 
re questo genere di problemi, la libreria boost 
fornisce una funzione apposita, chiamata 
const_pointer_cast: 

int main() 

{ 

shared_ptr< const Musica> musica(new 

Musica("Bach.MP3")); 

shared_ptr< Musica > 
musicaNonConst(const_pointer_cast<Musica>(musica 

)))_ 

RinominaMusica(musicaNonConst, 

"Beethoven. MP3"); 
cout << musica. use_count() << endl; // 2 

(giusto!) 
T~ 

Questa soluzione è corretta, come testimonia la 
chiamata a musica.usejcountO, che restituisce 
giustamente 2 (un riferimento da musica, ed 
uno da musicaNonConst) . Const _pointer_cast 
serve quindi ad ottenere uno smart pointer 
privo del vincolo di costanza, che condivide il 
possesso con lo smart pointer di partenza. Allo 
stesso modo vengono fornite le funzioni sta- 
tic_pointer_cast, e dynamic_pointer_cast, per 
emulare il comportamento degli operatori sta- 
ticjcast e dynamicjcast. 



Ref Co ii liti n g_ptr 



delta 



Ref Co il liti il g_|>tr 



dtltil 



Ref Co il liti il cj_l J * r 



dtlttl 




Musica 



titolo 



autore 



formato 



co unte r = 3 



• Intrusive_ptr 

Se sono riuscito nel mio intento affabulatorio, a 
questo punto vi starete convertendo alle grazie 
di shared_ptr, e promettendo solennemente a 
voi stessi che mai più userete un auto_ptr in vita 
vostra. Dato che so di non essere così convin- 
cente, più probabilmente vi starete chiedendo 
quali siano i vantaggi di un auto_ptr tali da vale- 
re la seccatura della copia distruttiva. Rispondo 
io. A parte il fatto che in rari casi la copia distrut- 
tiva è proprio il comportamento che volete otte- 
nere, gli shared_ptr hanno un costo, sia in ter- 
mini di memoria, sia di prestazioni. 
Dalla figura 1 potete intuire la ragione principa- 
le di quest'overhead: ad ogni smart pointer 
viene aggiunto un puntatore al contatore dei 
riferimenti. Sono solitamente 4 byte in più da 
memorizzare, e del lavoro in più per ogni copia 
e distruzione. 

Intendiamoci, normalmente non si sente mini- 
mamente il peso di un puntatore in più, ma se si 
vogliono realizzare migliaia di riferimenti sha- 
red_ptr, l'overhead diventa statisticamente 
significativo. Come spiegavo qualche paragrafo 
fa, la soluzione a questi problemi si raggiunge 
aumentando il "dialogo" fra lo smart pointer e il 
resto deir applicazione: in questi casi, infatti, si 
può usare uno smart pointer intrusivo (v. figura 
2). 

Questo genere di smart pointer non ha bisogno 
di memorizzare la posizione del contatore, per- 
ché sa già dove si trova: air interno dell'oggetto 
puntato. Così facendo ogni smart pointer intrusi- 
vo prende solo lo spazio di un puntatore, proprio 
come un auto_ptr. C'è un "però" piuttosto ovvio: 
l'oggetto puntato deve essere a conoscenza del 
fatto che riceverà le attenzioni degli smart poin- 
ter intrusivi, e deve quindi memorizzare il conta- 
tore e fornirne un'interfaccia di accesso. 
In termini pratici, la libreria boost fornisce un 
intrusive_ptr come smart pointer intrusivo, e 
impone di sovraccaricare esternamente ad ogni 
classe da referenziare, le funzioni void intrusi- 
ve_ptr_add_ref (Classe*), e void intrusive _ptr_ 
release(Classe*), rispettivamente per aggiungere 
o togliere un riferimento. L'implementazione più 
ingenua e minimalista possibile di una classe che 
soddisfi questi requisiti è quella che segue: 



Fig. 2: Una tipica implementazione di smart pointer intrusivo, con il contatore inca- 
psulato dall'oggetto puntato. 



struct IntrusiveCounted 


{ 


int counter; 




IntrusiveCountedQ 


: counter(O) {} 




}; 


ini 


ine void intrusive_ptr_add_ 


_ref(IntrusiveCounted* 


P) 


{ 


p->counter++; 
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} 


inline void 


intrusive_ptr_release(IntrusiveCounted* 


P) 


{ 




if CIC— P- 


>counter)) 






delete 


p; 




} 



Si tratta davvero di un'implementazione nai'f: il 
contatore è lasciato al pubblico scempio, le funzio- 
ni non sono incluse in alcun namespace, e la paro- 
la thread-safety è lontana anni luce! Tuttavia ho eli- 
minato ogni orpello di design, per permettervi di 
valutare in modo immediato come funzioni una 
classe che debba essere referenziata da un intrusi- 
ve _ptr. Poiché dovrete ripetere ogni volta tutte que- 
ste dichiarazioni, finirete col comportarvi come 
fanno tutti gli altri programmatori: scriverete una 
volta sola una bella implementazione completa di 
IntrusiveCounted, la salverete in un file tipo 
"IntrusiveCounted.hpp", e la userete come base da 
cui derivare pubblicamente. 

[...] //altri include standard 

#include <boost/intrusive_ptr.hpp> 

#include <IntrusiveCounted.hpp> 

//ora è sufficiente derivare pubblicamente da 

IntrusiveCounted 
struct Musica : IntrusiveCounted 



{ 



string titolo; 



Musica(const stringa _titolo) : titolo(_titolo) 

{}]_ 

~Musica() {cout << titolo << " e' stata 

distrutta!" << endl;} 



>; 



int main() 



{ 



intrusive_ptr<Musica> musica(new 

Musica("Bach.MP3")); 
// [...] usate musica come uno shared_ptr 



[-] 



} 



Come vedete, una volta scritta la classe base, 
costruire un nuovo tipo che sia referenziabile da un 
intrusive_ptr, o aggiornare una classe preesistente, 
è davvero semplice e intuitivo. Più diffìcile è stabi- 
lire a priori quando è preferibile usare uno sha- 
red_ptr, e quando, invece, conviene un 
intrusive_ptr. In linea teorica bisognerebbe ricorre- 
re ai primi quando si hanno più riferimenti che 
oggetti e ai secondi in caso contrario, ma la que- 
stione non è così netta. La linea consigliata dagli 
stessi creatori della libreria è: se siete in dubbio, pro- 
vate prima con sharedjptr. 



aveste avuto pazienza, vi avrei svelato uno dei 
casi in cui è possibile mandare in crisi perfino il 
robustissimo shared_ptr. La vostra iniziazione è 
finita, e ora possiamo parlarne. Proviamo a defi- 
nire il comportamento di un eroe dell'antica 
Grecia, come mostrato nella figura 3: 




ti 












r-t 


Liberto 




padrone 



















lif 














|-* 


Eroe 




p* 


Eroe 




pache 


padre 






figlio 


figlio 

















Fig. 3: Due riferimenti circolari in cui l'uso di shared_ptr causa un memory-leak. In 
A, un liberto diventa il padrone di se stesso; in B, padre e figlio si "sorreggono a 
vicenda". 

struct Eroe 



{ 



string nome; 



shared_ptr<Eroe> padre; 



shared_ptr<Eroe> figlio; 



Eroe(const string& _nome) : nome(_nome) 

{}; 

~Eroe() {cout << "Sventura! Il grande " 

<< nome << " e' morto!";}; 



void Presentata) { 



cout << "Io sono " << nome; 



if (padre) 



cout << ", figlio di " << 
padre->nome; 



if (figlio) 



cout << ", padre di " 

<< figlio->nome; 



cout << ".\n"; 



int main() 



{ 



shared_ptr<Eroe> priamo(new 

Eroe("Priamo")); 
shared_ptr<Eroe> ettore(new 

EroefEttore")); 



priamo->figlio = ettore; 



ettore->padre = priamo; 



ettore- > Presentata) ; 



priamo- > Presentalo ; 



} 



L'esecuzione di questo programmino ci dà l'im- 
pressione di aver fatto proprio un buon lavoro: 



BIBLIOGRAFIA 



SCOTT MEYERS 

Effective C++ (la terza 
edizione ha degli 
ottimi riferimenti su 
shared_ptr) 
More Effective C++ (ha 
una lunga sezione 
sull'implementazione 
"artigianale" di vari 
sistemi di reference 
counti ng) 

HERB SUTTER 

Exceptional C++ 
(numerosi riferimenti 
su auto_ptr e 
l'exception safety) 
More Exceptional C++ 
(idem) 



ANDREI 



Modem C++ Design 
(presenta la classe 
smart_ptr di Loki) 

BJÒRM 
KARLSSOM 

Beyond the C++ 
Standard Library 
(ottima introduzione a 
boost) 



• Weak_ptr 

All'inizio di quest'articolo vi ho detto che, se 



Io sono Ettore, figlio di Priamo. 



Io sono Priamo, padre di Ettore. 
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Per ogni 

richiesta/critica/sugger 

imento l'autore può (e 

deve!) essere 

contattato all'indirizzo 

articoli@robertoallegr 

a.it 



Ma. . . un momento! Dove sono i messaggi di "sven- 
tura" che dovrebbero essere stampati alla distru- 
zione dei due eroi? Non ci sono, e ciò significa una 
cosa sola: memory leak. Il fatto è che lo shared_ptr 
priamo->flglio tiene in vita Ettore, e ettore->padre 
tiene in vita Priamo, tanto è vero che alla fine di 
main Fuse count di entrambi è 2. Quando main ter- 
mina, i due shared_ptr locali priamo ed ettore ven- 
gono distrutti, ma non le loro risorse, dal momento 
che lo use_count dei loro riferimenti interni è 
ancora 1! Come mostra questo esempio, i puntato- 
ri come shared_ptr tengono in vita l'oggetto al 
quale puntano, e vengono per questo definiti pun- 
tatori forti. Per spezzare il ciclo, occorre usare un 
puntatore debole. Finora conosciamo un solo 
puntatore debole: Eroe* - ovverosia il puntatore stu- 
pido. Ma usarlo non è una buona idea. 



^ 



//in 


questo esempio, Eroe::Padre è un puntatore 

stupido 


int main() 


{ 




shared. 


_ptr<Eroe> priamo(new 

Eroe("Priamo 


')); 




shared. 


_ptr<Eroe> ettore(new 

Eroe ("Etto re 


')); 




priamo 


->figlio = ettore; 






ettore- 


>padre = priamo. get(); 






priamo 


reset(); //uccidiamo Priamo 






ettore- 


>Presentati(); 




} 



sto: weak_ptr. 

Ci sono un paio di cose importanti da sapere su 
weak_ptr: la prima è che è possibile usare il 
metodo expiredO per sapere se il riferimento al 
quale punta è ancora in vita. La seconda è che 
weak_ptr non permette l'accesso all'oggetto 
puntato direttamente, ma espone il metodo 
lock(), che crea uno shared_ptr, che può a sua 
volta essere usato per utilizzare l'oggetto. In que- 
sto modo si ha una maggior sicurezza: se l'ogget- 
to non esiste più, lo shared_ptr restituito sarà 
vuoto. Dangling pointer, addio! La definizione di 
Eroe deve cambiare così: 



struct Eroe 


{ 


//[-] 




weak_ 


ptr<Eroe> padre; 






sharec 


_ptr<Eroe> figlio; 




//[-] 


void Presentata) { 






cout << 


'Io sono " 


<< nome; 






if (Ipadre 


.expiredO) 










cout << " 
padre. 


, figlio di " << 
lock()->nome; 


if (figlio) 








cout << " 
<< 


, padre di " 
figlio->nome; 






cout << 


'■\n"; 




} 


}; 



L'esecuzione di questo programma va in crash, 
con un output del genere: 



Ora l'esecuzione del programma è finalmente 
corretta e priva di memoryjeak: 



Sventura! Il grande Priamo e' morto! 
Io sono Ettore, figlio di ( 

Stavolta Priamo muore, secondo natura, ma ciò 
causa un dangling pointer nel membro padre di 
Ettore, ormai rimasto orfano, che "si commuove" al 
momento di dichiarare i suoi natali, mandando in 
crash l'applicazione. 

Per risolvere il problema correttamente, ci vuole uno 
smart pointer debole, che non tenga in vita l'ogget- 
to puntato, e boost mette a disposizione anche que- 



LOKI E SMART PTR 



Lo smart pointer smart_ptr della 
libreria Loki è sicuramente uno 
dei risultati più interessanti 
conseguiti dal policy based 
design predicato da 
Alexandrescu. Definendo 
opportunamente i parametri del 
suo template, è possibile 
utilizzare smart_ptr come un 



puntatore forte, debole, 
intrusivo, a reference counting, 
reference linking, copy on write, 
e tante altre combinazioni. Ne 
riparleremo sicuramente su 
queste pagine, quando 
discuteremo questo 
rivoluzionario sistema di 
programmazione. 



Sventura! Il grande Priamo e' morto! 

Io sono Ettore. 

Sventura! Il grande Ettore e' morto! ( 



CONCLUSIONI 

Finalmente potete riporre nella vostra cassetta 
degli attrezzi una serie di utensili universali, 
pronti a risolvervi molti problemi insidiosi. Per 
ora, il nostro viaggio nel paese degli smart poin- 
ter si conclude qui - ci aspettano altre avventure 
in altri luoghi affascinanti della Memoria, come il 
regno degli allocatori e quello dei Garbage 
Collector. Ma non abbiamo certo esplorato ogni 
loro possibilità, e vi prometto che torneremo 
presto ad approfondire questi argomenti. Gli 
shared_ptr, in particolare, permettono di usare 
dei custom deleter che valgono tutte le vostre 
attenzioni, e saranno sicuramente trattati fra 
queste stesse pagine in futuro. Non mancate! 

Roberto Allegra 
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T CORSI BASE 





ECLIPSE NEL 
MONDO REALE 



CHE USIATE ECLIPSE PER SVILUPPARE PROGETTI OPEN SOURCE O PER IL VOSTRO LAVORO 
IN AZIENDA, LE SUE INTEGRAZIONI CON I TOOL PIÙ USATI DEL MONDO JAVA POSSONO 
FACILITARVI LA VITA. VEDIAMO QUALI SONO GLI STRUMENTI A DISPOSIZIONE 



Java è ormai un signore di mezza età, e il 
suo placido mondo è diventato una gran- 
de famiglia di standard di fatto: utility, 
librerie e framework. A volte sembra che non 
sia rimasto niente da inventare: se devo auto- 
matizzare la costruzione e l'installazione del 
mio sistema, userò probabilmente Ant o 
Maven; se devo testare il codice, la voce popo- 
lare mi suggerisce di usare JUnit; e così via. E 
visto che la "I" della parola "IDE" sta per "inte- 
grato", mi aspetto che il mio sistema di svilup- 
po sia buon amico di tutti questi arnesi, e mi 
permetta di usarli con la stessa facilità con cui 
uso il suo editor o il compilatore Java. 
Per fortuna Eclipse è uno tra i membri più 
socievoli della famiglia Java. Grazie alla sua 
struttura aperta possiamo scaricare rapida- 
mente nuovi componenti per integrarlo con 
gli altri strumenti di sviluppo. E spesso non ne 
abbiamo nemmeno bisogno, perché la distri- 
buzione standard di Eclipse è già integrata 
con quasi tutti i tool davvero indispensabili. 
In questo articolo parleremo dell'integrazione 
tra Eclipse e tre utensili importanti per la 
vostra cassetta degli attrezzi Java: Subversion, 
JUnit e Ant. 



PRIMA PARTE 
ECLIPSE SU MISURA 

Per prima cosa vediamo come scaricare e installare 
un plug-in che integra Eclipse con uno strumento 
esterno. Cominciamo con il sistema di versiona- 
mento, che descriveremo in dettaglio nella seconda 
parte dell'articolo. 

La distribuzione standard di Eclipse supporta già 
CVS, il più popolare version manager open source. 
Se selezionate il comando di menu Window->Open 
Perspective->Other, vedrete che avete già una "pro- 
spettiva CVS". Ma in questo articolo useremo un 
sistema di versionamento un po' più moderno: 
Subversion. 

Subversion (a volte abbreviato in SVN) è il candi- 
dato per la successione al trono di CVS. E' proba- 
bile che prima o poi Eclipse decida di supportare 
Subversion nella distribuzione standard, ma fino a 
quel momento dobbiamo installare un plug-in 
apposta. Basta una rapida ricerca con Google per 
individuare Subclipse, un plugin sviluppato dagli 
stessi autori di Subversion. Il plugin contiene tutto 
quello che vi serve per connettervi ad un reposi- 
tory Subversion da Eclipse. Connettetevi a Internet 
e scegliete Help->Software Updates->Find and 
Instali. Apparirà una finestra che vi chiede se vole- 




r >v 

Ci CD □ WEB 

Eclipse 3.2. 




Basi di Eclipse e Java 

> Una qualsiasi versione 

J del runtime o delI'SDK 

di Java, Eclipse 3.2. 



ih 



Tempo di realizzazione 







Update sites to visit 

Select update sites to visit while looking for new features. 



Sìtes to include in search: 



~~ | «A CaÉsto Dfccovery Site 

I | ^The Eclipse Project update site 



New Remote Site... 



New Locai Site.. 



New Archìved Site... 



New Update Site 



Name: | Subclipse 



URL: http : //su bclipse.tig ris.or g/u pdate_ 1 . . x| 



SOTTO VERSIONE 



C'è chi dice che per scrivere softwa- 
re servono tre cose: un computer, 
un compilatore e un sistema di ver- 
sionamento. I primi due strumenti 
sono riconosciuti da tutti come 
indispensabili, ma non tutti cono- 
scono l'importanza del terzo. 
Diciamo che potete fare a meno del 
versionamento, a patto che adoria- 
te passare ore per cercare di capire 
chi ha modificato un file; che vi 
piaccia l'idea di perdere l'unica ver- 
sione funzionante del vostro pro- 
getto; che i problemi di integrazio- 
ne siano per voi un piacere subli- 



me; e che non abbiate niente in 
contrario a cercare file di sorgente 
tra migliaia di vecchi messaggi di 
mail. In caso contrario, vi conviene 
usare il versionamento. I sistemi di 
versionamento sono bestiole com- 
plicate, e in questo articolo non 
abbiamo lo spazio per parlarne a 
lungo. Potete leggere i concetti di 
base nel box "lo e il repository". Vi 
incoraggiamo a studiare il resto per 
conto vostro. Non avete scuse: i 
"version control system" più popo- 
lari, come CVS e Subversion, sono 
belli gratis. 
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imparare Eclipse 
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te cercare aggiornamenti per i componenti già 
installati, o installarne di nuovi. Selezionate la 
seconda opzione {Search for new features to 
instali) e premete Next. La finestra successiva con- 
tiene la lista dei siti di update. Aggiungiamo il sito 
di Subclipse alla lista: scegliete New remote site, 
inserite l'indirizzo http:/ /subclipse. tigris.org/upda- 
te_1.0.x e dategli un nome qualsiasi. 
Selezionate il nuovo sito di update e cliccate su 
Finish. Eclipse contatterà il sito di update e vi 
mostrerà quello che ci ha trovato sopra. Mentre scri- 
viamo, l'unico plugin disponibile su questo sito è la 
versione 1.0.3 di Subclipse. Selezionatelo e cliccate 
su Next per proseguire con l'installazione. Le opzio- 
ni successive sono semplici: dovete accettare la 
licenza, decidere dove mettere i file del plugin (per 
default finisce nella stessa directory dei plugin stan- 
dard di Eclipse) e confermare l'installazione. 
Quando avrete finito, Eclipse vi chiederà di riavviare 
il workbench. 

Per verificare che l'installazione abbia avuto succes- 
so, scegliete Help->About Eclipse SDK e cliccate su 
Feature Details. Dovreste vedere tra le altre una fea- 
ture di nome Subclipse. Verificate che funzioni: sce- 
gliete Window->Open Perspective->Other e control- 
late che nella lista delle prospettive ce ne sia una che 
si chiama SVN Repository Exploring. Apritela e 
andiamo avanti. 



SECONDA PARTE 
IL CODICE 

Ora che abbiamo installato Subclipse, possiamo 
usarlo per accedere ad un progetto conservato in un 
repository Subversion. Se non avete esperienza di 
versionamento, leggete i box "Sotto versione" e "Io e 
il repository". 

Se avete seguito il paragrafo precedente, dovreste 
essere di fronte alla prospettiva SVN Repository 
Exploring. Cliccate con il tasto di destra in questa 
vista e scegliete New->Repository Location. Come 
URL, inserite http://svn.laughingpanda.org/svn/indian- 
poker/trunk / e premete Finish. Nella vista sulla sini- 



Selegatet delegatole - delegate?] 
ntucn d» Legator, delegate Ebot, t 



privata TOld in-^relegacaESI} { 

d*;*gitfll* . [Kit E "Bor . r pu rr.Mwr.c gì 
dftlt^ÈCtìri . ptìC ( *fct . hand3 1. ir l s " , 
Argute» . mit E "Son . paidflT. i nd"„ 
delegatela . piti E "ftot . playerÀcted 1 
d»;» gjitfll» . pwt E "Bot . a cr jfln " d i 
delegate» . put [ »tot . ihawCartl" , 
dragatori . put E 'Bot - psrfomwd' 



Delegarci: delegete* - delega- * 
return d*l*g*tOTnd»L«gat«tbfl- 



privata v«id iftirBelegftiara ( J [ 
d* Legatori ,pot { "Bo-t . tsunwwì 
deleparers.pux { "Sac . handitar 
d#Lagatera- T pot t "Bot . p*i dei im 
deleoacors^put i M Bet . playetAc; | 
dt Legate» T put { "Bot r Action" r ; 
deLesatcrs^ptit { H Boc . ahcwCaxd, 
dt Legatori ,pot I "Sot . p«rf orw 
delegatori^pticCSec.-wtìtì - , w 

! 



lnt*rf»ca T^l*nfl!-i 



stra apparirà un nuovo repository, che potete esplo- 
rare come se fosse un albero di folder locali. Tra gli 
altri file, ne vedrete uno che si chiama .project- que- 
sto è un indizio del fatto che il repository contiene 
un progetto Eclipse. Cliccate sul repository con il 
tasto di destra e scegliete Checkout per scaricare il 
progetto in locale. 

Selezionate tutte le opzioni di default nelle finestre 
che seguono. Abbiate pazienza, ci vorrà un po' per 
scaricare tutti i file del progetto. Alla fine tornate alla 
prospettiva Java. Dovreste vedere nel Package 
Explorer un progetto di nome indianpoker (vedi box: 
"Poker all'indiana"). 

Ora che avete scaricato il progetto potete modificar- 
ne i file, ma non potete inserire le vostre modifiche 
nel repository - per farlo dovreste entrare nel team 
di sviluppo e farvi dare una password. Però potete 
farvi un'idea di come si lavora con uno strumento 
come Subversion. Modificate un qualsiasi file del 
progetto e salvatelo (Subclipse dovrebbe identificare 
i file e i folder modificati con un piccolo asterisco). 
Cliccate con il tasto di destra sul file modificato e 
selezionate il menu Team. Questo menu contiene i 
comandi del sistema di versionamento. Ad esempio: 
il comando Commit permette ai membri del team di 
inserire le proprie modifiche nel repository, Update 
permette di scaricare le modifiche di qualcun altro, 
e Revert cancella le modifiche locali e riporta il file 
allo stato in cui era durante l'ultimo update. 
Scegliete il comando Synchronize with Repository 
per aprire la prospettiva Team Synchronizing. In 
questa prospettiva potete confrontare la versione 
locale del progetto con quella nel repository. Ad 
esempio potete vedere cosa avete cambiato voi e 
cosa hanno cambiato gli altri. La vista Synchronize 
mostra le differenze tra i file locali e il repository. 
Cliccando sulle icone in cima alla vista potete vede- 
re i file modificati localmente, quelli modificati nel 
repository, entrambi, o i file "in conflitto" (quelli che 
sono stati modificati sia localmente che nel reposi- 
tory). 

Cliccate con il tasto destro sul file che avete modifi- 
cato e scegliete Open In Compare Editor. Si aprirà un 
editor che mostra le differenze tra la versione locale 
e quella remota del file. 
Un'altra funzionalità utile del sistema di versiona- 
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mento è quella che mostra la storia passata di cia- 
scun file. Tornate alla prospettiva Java e selezionate 
una classe qualsiasi - ad esempio orglaughingpan- 
da.games. poker, indian.domain. Card. Cliccateci 
sopra col tasto destro e scegliete Team->Show in 
Resource History. Apparirà una vista di nome SVN 
Resource History che mostra tutte le precedenti ver- 
sioni del file, ciascuna con la sua data, il nome del- 
l'autore ed il commento inserito dall'autore duran- 
te il commit. Potete anche selezionare due versioni 
per esplorarne le differenze. Con uno strumento 
così è facile mantenere il controllo su quello che 
succede al codice. 



test del progetto test fallisce, la barra diventa rossa. 
Vediamo cosa succede se introduciamo un bug nel 
codice. Tornate al Package Explorer e guardate nel 
folder srcmain. Cercate la classe che rappresenta 
una "mano" del gioco: orglaughingpanda.games. 
poker.indian.domain.Hand. Questa classe contiene 
un metodo per verificare se tutti i giocatori hanno 
avuto modo di fare la loro puntata: 
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© © BlindsStrategy.java 8 11/ 
© © Card .java 30 14/11/06 1: 
©■■■E) DeckjavaS 11/07/06 21 
©■■■GÌ DefaultDeck.java 8 11/07 
É-Dà DefaultHandListener.java l 
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©■© RxedBlinds.java 8 11/07/ 
è~El Hand.javaS 1 1/07/06 21 
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SVN Resource History (Card .java) 
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07/11/06 18.50 


Ikoskela 


Checking in changes ma de by Paob Perro 


8 


11/07/06 21.36 


mhjort 


Refactored packages.[...] 


7 


11/07/06 20.23 


mhjort 


Added author tags. 


4 


11/07/06 20.03 


mh]ort 


Added license texts. 


2 


26/06/06 17.28 


mhjort 


Copied from AgileFinland SVN repo.[...] 



TERZA PARTE 

LA RETE DI SICUREZZA 

Diamo un'occhiata all'integrazione tra Eclipse e il 
framework JUnit (leggete il box "Tanti piccoli test" se 
non conoscete JUnit). Il progetto che stiamo usando 
come esempio contiene due folder di sorgenti. Una 
{srcmain) contiene il codice "di produzione", l'altra 
Isrctest) contiene i test. La struttura dei package è la 
stessa per i due folder. Questo è uno dei tanti modi 
di organizzare i test, ma non l'unico. In certi proget- 
ti i test sono negli stessi folder del codice di produ- 
zione, o in package separati. 
Esplorate il codice dei test per farvi un'idea di come 
funziona. In generale ciascun test è un metodo (un 
"test case") all'interno di una classe (il "test"). JUnit 
usa delle semplici convenzioni per trovare ed ese- 
guire i test - ad esempio, le classi di test ereditano 
dalla classe junit.framework.TestCase, e ciascun 
metodo di test ha un nome che inizia per "test". 
Cliccate con il tasto di destra sul progetto, e sceglie- 
te Run As->JUnit Test. Eclipse andrà a cercare tutti i 
test unitari nel progetto (nello stesso modo è possi- 
bile eseguire un singolo test, o tutti i test sotto un 
certo folder). Apparirà una vista JUnit. Man mano 
che i test vengono eseguiti vedrete avanzare una 
barra verde. Se anche uno solo dei quasi duecento 
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private boolean 


alIPlayersHaveHadCha 


iceToAct(int 
actions) { 


return actions 


>= players.sizeQ; 




} 



Modificate il confronto per introdurre un subdolo 
bacherozzo: 

private boolean allPlayersHaveHadChanceToAct(int 

actions) { 



return actions > players.sizeQ; 



> 



Ora fate girare nuovamente i test, e vedrete apparire 
una barra rossa. JUnit vi segnalerà anche quali test 
sono falliti. Se cliccate sui test falliti, vedrete uno 
"stacktrace" dell'errore che vi permette di arrivare 
direttamente al codice colpevole. 
Grazie ai test unitari, abbiamo buone chance di 
identificare gli errori prima che causino danni. 
Provate a introdurre errori in diverse parti del codi- 
ce per vedere quali sono ben testate. 
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QUARTA PARTE 

IL PICCOLO MURATORE 

Prima di finire, parliamo dell'integrazione tra 
Eclipse e Ant, il più popolare sistema di build per 
Java. 

Costruire un sistema Java è semplice solo se il siste- 
ma è semplice. In questo caso basta compilarlo e 
lanciarlo. Ma la tipica "build" del sistema richiede 
molte altre operazioni. Di solito voglio impacchet- 
tare le mie classi Java in una serie di file JAR, aggiun- 
gere tutte le librerie scaricate da Internet, far girare i 
test per controllare che tutto funzioni ancora, e 
magari anche fare il "deploy" del sistema, cioè 
installarlo e renderlo operativo su una macchina di 
test o direttamente in produzione. Alla fine, non è 
raro che per un piccolo aggiornamento (ad esem- 
pio, per correggere un bug) si perda più tempo per 
tutte queste operazioni che per lavorare sul codice. 
Capita di incontrare progetti nei quali mettere un 
sistema in produzione richiede un intero giorno di 
lavoro. 

Per fortuna c'è Ant, il più famoso sistema di build 
per Java. Ant è una versione riveduta e corretta del 
vecchio programma make usato dagli sviluppatori 
C. Permette (con un po' di lavoro) di scrivere degli 
script che automatizzano le operazioni lunghe e 
noiose di build e deploy. Lo script è un file XML (di 
solito si chiama build.xml) che contiene una serie 
di compiti da eseguire (Ant li chiama "target"). In 
questo articolo non spieghiamo in dettaglio come 
funziona Ant, ma se lavorate in Java probabilmente 
lo avete già incontrato. Eclipse supporta già Ant 
senza bisogno di aggiungere alcun plug-in esterno. 
Andate nella root del progetto indianpoker e trove- 
rete un file di nome build.xml. Apritelo nell'editor. 
L'editor Ant di Eclipse è in grado di fare cose com- 
plicate come trovare gli errori nello script (il che, 
come potete immaginare, è un bel vantaggio quan- 
do si lavora con un programma scritto in un dialet- 
to di XML). 

Questo particolare file contiene solo due target. Il 
target compile compila tutte le classi (ma non i test) 
con il compilatore javac, e il target package impac- 
chetta i file del client (e le librerie necessarie) in un 
unico fileyar sotto la directory disi. Il secondo target 
"dipende" dal primo - questo significa che se lan- 
ciate package, Ant garantisce che venga prima ese- 
guito compile. 
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Quando un file di build contiene molti target, capi- 
re la struttura del file leggendo l'XML diventa diffi- 
coltoso. Meglio aprire una vista apposta. Scegliete 
Window->Show View->Ant per mostrare la vista 
Ant. Trascinateci dentro il file build.xml per vedere i 
due target. Il target package è marcato con una trec- 
cina per indicare che è il target di default - quello 
che viene eseguito automaticamente se si lancia la 
build senza specificare quale target eseguire. 



Qutline KK ^l ° B 

Q j£| indianpoker 

+ ■!■ compile 

< > delete dist/pokerclient.jar 

; < > unjar lib/commons-codec-1.3.jar 

;•■■■•< > unjar fib/xmlrpc-2.a.jar 
=•■■■ <> jar dist/pokerdient jar 



L'idea è che per "rilasciare" il progetto si lancia il 
target package, che costruisce la libreria neces- 
saria per implementare i client del gioco. Poi si 
distribuisce questo file ai giocatori. Proviamoci. 
Andate sul file build.xml nel Package Explorer (o 
sul target package nella vista Ant) e selezionate 
Run As->Ant Build dal menu contestuale. 
Vedrete Ant sparare un po' di informazioni nella 
Console. Quando la build sarà terminata (dopo 
pochi secondi) cliccate col tasto destro sul pro- 
getto indiapoker e scegliete refresh per chiedere 
ad Eclipse di allineare il progetto al vostro file 
system. Vedrete nel progetto un nuovo folder 
disi che contiene, oltre a un po' di file tempora- 
nei, anche il file pokerclient.jar. 



CONCLUSIONI 

In questo articolo abbiamo visto, in piccolo, un 
ciclo di sviluppo completo: abbiamo estratto un 
progetto dal suo repository, lo abbiamo modificato, 
abbiamo fatto girare i test e abbiamo lanciato la 
build per ottenere i file da distribuire. Tutto questo 
è stato possibile grazie all'integrazione di Eclipse 
con una serie di tool esterni. 
Ma forse nel vostro caso vi tocca integrare Eclipse 
con JBoss, o con Tomcat, o con Maven, o con uno 
qualsiasi degli altri strumenti tipici del mondo Java. 
Nessun problema: cercate su Internet, e probabil- 
mente troverete un plug-in pronto per l'uso. Le 
famiglie numerose come quella di Java hanno i loro 
svantaggi, ma almeno si ha la sicurezza di non esse- 
re mai da soli. 

Paolo Perrotta 
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Turbo C++ per Windows 2006 



C++ SECONDO BORLAND 

Borland è una delle software house stori- 
che nel mercato dello sviluppo. Non si 
dimentica che proprio Borland ha svilup- 
pato uno dei primi linguaggi completa- 
mente ad oggetti: l'object Pascal già a 
metà degli anni 90. Allo stesso modo è da 
attribuirsi a Borland anche l'avvento degli 
IDE Rad con il mitico Delphi. Per qualche 
anno si era allontanata dal mercato dei 
tool di sviluppo rivolti alla produttività 
individuale e solo di recente è ritornata 
con prepotenza ad occupare questo setto- 
re. La nuova linea di prodotti prende il 
nome di Turbo e vi appartengono Turbo 
C#, Turbo Delphi, e anche questo meravi- 



glioso Turbo C++ per Windows. 
Compilatore ultraveloce dotato delle 
caratteristiche che da sempre hanno fatto 
grande i prodotti Borland. Prima di tutto 
una forte attitudine all'uso dei "compo- 
nenti", ve ne sono circa 200 inclusi in que- 
sto pacchetto e poi un 1 IDE straordinaria- 
mente ricco, affidabile e stracolmo di fea- 
tures che facilitano la vita al programma- 
tore. A fare da contorno a tutto questo un 
compilatore che produce codice altamente 
ottimizzato e veloce. Caratteristica essen- 
ziale per chi sceglie C++ come riferimento 
nei propri progetti di sviluppo 
Directory :/turbocpp 




JAVA SE 
DEVELOPMEIMT 
KIT 5.0 UPDATE 9 

IL COMPILATORE INDISPENSABILE 
PER PROGRAMMARE IN JAVA 

Se avete intenzione di iniziare a program- 
mare in Java oppure siete già dei program- 
matori esperti avete bisogno sicuramente 
del compilatore e delle librerie Java indi- 
spensabili. Sotto il nome di Java SE 
Development Kit vanno appunto tutti gli 
strumenti e le librerie nonché le utility 
necessarie per programmare in JAVA. 
L'attuale versione è la 5.0 Update 9, ad un 
passo dall'attesissima versione 6 e imme- 
diatamente precedente al rilascio del 
codice di Java sotto forma OpenSource. 
Directory:/j2se 

ECLIPSE SDK 3.2.1 

L'IDE TUTTOFARE 

Eclipse è un progetto completo portato 
avanti da Eclipse Foundation con la col- 
laborazione di una miriade di aziende fra 



cui IBM, Adobe, Sun e che si è prefissata 
lo scopo di creare un IDE estendibile per 
plugin adattabile a qualunque tipo di lin- 
guaggio o tecnologia. Di default Eclipse 
si propone come IDE per Java ed è qui 
che da il meglio di se. Ma proprio grazie 
ai suoi plugin è possibile utilizzarlo come 
ambiente di programmazione per PHF! 
per C++, per Flex e per molti altri lin- 
guaggi ancora. Inoltre sempre grazie per 
ciascun linguaggio sono disponibili altri 
plugin ad esempio per rendere l'ambien- 
te RAD o per favorire lo sviluppo dei Web 
Services o altro. Insomma lo scopo è 
stato raggiunto completamente. Eclipse 
è realmente un IDE tuttofare, ormai 
maturo, e che serve una miriade di pro- 
grammatori grazie alle sue caratteristi- 
che di affidabilità e flessibilità. Unica 
nota negativa: una certa pesantezza che 
lo rende idoneo ad essere usato solo su 
PC con una dotazione hardware minima 
di tutto rispetto 
Directory :/eclipse 



PHP 5.2.0 

IL LINGUAGGIO DI SCRIPTING 
PIÙ AMATO DEL WEB 

Sono tre le colonne portanti di Internet: 
PHP, APACHE e MySQL. Certo la con- 
correnza è forte. Asp.NET e SQL Server 
avanzano con celerità, ma a tutt'oggi 
non si può affermare che i siti sviluppa- 
ti in PHP costituiscano la stragrande 
maggioranza di Internet. Quali sono le 
ragioni del successo di cotanto linguag- 
gio? Prima di tutto la completezza. PHP 
ha di base tutto quello che serve ad un 
buon programmatore, raramente è 
necessario ricorrere a librerie esterne, e 
quando è proprio indispensabile farlo 
esistono comunque una serie di reposi- 
tory che rendono tutto immediatamen- 
te disponibile ed in forma gratuita. Il 
secondo punto di forza del linguaggio 
sta nella sua capacità di poter essere 
utilizzato sia in modo procedurale che 
nella sua forma ad oggetti certamente 
più potente e completa. Esiste un terzo 
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di punta di forza essenziale che è quel- 
lo riguardante la curva di apprendi- 
mento. PHP è in assoluto uno dei lin- 
guaggi con la curva di apprendimento 
più bassa nel panorama degli strumen- 
ti di programmazione. Si tratta perciò di 
uno strumento indispensabile per chi si 
avvicina alla programmazione web, a 
meno che non intendiate scegliere stra- 
de diverse quali possono essere 
ASP.NET o JSP 
Directory:/php 

PHALAMGER 2.0 

PHP IN TECNOLOGIA .NET 

Ok, siete dei programmatori PHP ma vor- 
reste che il vostro sito girasse in tecnologia 
.NET. Sapete che il miglio modo per far 
girare un sito sotto US sfruttandone tutte 
le potenzialità è scrivere codice .NET. 
Come fate? Facile! La soluzione esiste e si 
chiama Phalanger. Scrivete il vostro codice 
in PHP ma in realtà ottenete una pagina 
compilata in .NET. E' necessario installare 
qualcosa sul server, ma i risultati sono 
entusiasmanti! 
Directory :/phalanger 

niEMERLE 0.9.3 

L'EMERGENTE SIMILE AL C# 

Di tanto in tanto in programmazione 
arrivano delle novità assolute che 
inizialmente sfuggono al grande 
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pubblico per poi diffondersi 
lentamente nel corso del tempo ed 
arrivare alla piena maturità in un 
periodo di tempo abbastanza lungo. E' 
stato il caso di Ruby molti anni fa e di 
Python ancora prima. E'il caso di Boo e 
di Nemerle adesso. Nemerle è un 
linguaggio nato per la piattaforma 
.NET con una sintassi molto simile al 
C#. Si tratta di un linguaggio 
fortemente tipizzato ed orientato agli 
oggetti ma con la possibilità quando è 
il caso di essere utilizzato nella sua 
forma procedurale e da questo punto 



di vista segue i concetti cari al PHP. 
Altro aspetto interessante è quello di 
poter utilizzare le macro, mentre si 
avvicina per alcuni aspetti a Python 
quando si tratta di usare le liste ad 
esempio. Si tratta di un progetto 
interessante che merita una particolare 
attenzione. Nonostante la sua giovane 
età sembra infatti promettere alcune 
funzionalitò che potrebbero renderlo 
molto diffuso anche in breve tempo 
Directory:/nemerle 



BOO 0.7.6 

SEMPLICE ED ELEGANTE 




Mettiamo che vi piaccia Python ma non 
amate molto dovervi servire di librerie 
esterne, inoltre siete affascinati da .NET 
ma non vi piacciono i linguaggi che sot- 
tendono a questa tecnologia, fate uno + 
uno ed ecco il Boo. E' esattamente il 
ragionamento fatto da Rodrigo Barreto 
de Oliveira il quale aveva proprio voglia 
di un linguaggio simile al Python e che 
supportasse .NET e MONO ed ha tirato 
fuori il BOO. E nonostante il nome si 
presti a mille giochi di parole, almeno 
per la lingua italiana, bisogna dire che 
il linguaggio sta già ottenendo un 
discreto successo. Soprattutto Mono 
sembra già spingerlo a sufficienza e tut- 
tavia non tarderemo a vederne gli effet- 
ti anche su piattaforma Windows 
Directory:/boo 

RUBY.NET BETA 5 

IL NUOVO CHE AVANZA 

Ruby, probabilmente lo conosce tutti. 
E' un linguaggio nato ormai da una 
decina d'anni inizialmente con la prete- 
sa di essere uno strumento matematico 
dalle caratteristiche avanzate. Nel 
tempo si è evoluto e migliorato fino a 
raggiungere oggi una piena maturità 
che lo colloca fra i linguaggi più usati 
dell'ultimo anno. Proprio uno dei fra- 




mework più noti sul web: Ruby On Rails 
ha vinto l'anno scorso il premio come 
miglior framework per lo sviluppo 
internet esistente, a dispetto di molti 
colosssi dell'informatica che operano 
in questo campo ed a testimonianza 
della grande maturità che questo lin- 
guaggio ha raggiunto. La sintassi è sem- 
plice, il linguaggio elegante, completo e 
particolarmete versatile, la curva di 
apprendimento molto bassa. Si tratta di 
uno strumento rapido che può coadiu- 
vare lo sviluppo tradizionale e perché 
no? in molti casi sostituirlo. In questo 
numero di ioProgrammo ve lo presen- 
tiam nella sua versione per .NET, parti- 
colarmente ottimizzato per Windows. 
Directory:/ruby 

IROHIPYTHOni 1.0.1 

UN'IMPLEMENTAZIONE DI PYTHON 
IN TECNOLOGIA .NET 

In molti conoscono Python. Si tratta di 
un linguaggio agile, dinamico, elegante, 
ad oggetti e multipiattaforma. Per le sue 
caratteristiche di estrema flessibilità, 
per la sua facilità nella curva di appren- 
dimento, per la sua leggerezza si tratta 
di un linguaggio estremamente diffuso 
su piattaforma Linux dove viene utiliz- 
zato per automatizzare gran parte delle 
impostazioni di sistema. Anche sul Web 
Python ha trovato una sua collocazione 
ben precisa, pare infatti che sia il lin- 
guaggio di scripting su cui si basa 
buona parte di Google. In ambiente 
Windows si sta diffondendo a macchia 
d'olio, tanto che oltre ad una versione 
standalone dell'interprete ne è appena 
nata anche una versione per .NET, 
appunto IronPython. Le caratteristiche 
sono identiche a quelle classiche di 
Python, ma il codice prima di essere 
eseguito viene convertito nel MIL di 
.NET con le conseguenti ottimizzazioni 
Directory:/iron python 
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ANT COLONY 
OPTIMIZATION 

OSSERVARE IL COMPORTAMENTO "SOCIALE" DI ALCUNI ANIMALI E INSETTI PUÒ ESSERE 
UN UTILE INSEGNAMENTO PER RIPRODURLO CON UN MODELLO ALGORITMICO. 
SI TRATTA DI UNA NUOVA FRONTIERA DELLO SVILUPPO: LA SWARM INTELLIGENCE 



Il comportamento di alcuni animali ed insetti ha 
da sempre suscitato interesse e a volte meravi- 
glia nell'uomo. Spesso ci siamo chiesti come sia 
possibile che stormi di rondini riescano a seguire 
rotte di volo così precise o siamo rimasti affascina- 
ti dalle geometrie descritte da sciami di api. Studi 
sulla biologia di tali animali hanno dato molte ri- 
sposte a riguardo. Ma tra tutti, l'insetto che suscita il 
maggiore interesse per il suo atteggiamento coope- 
rativo è la formica. Negli ultimi anni nel ambito del- 
la programmazione, tali comportamenti hanno co- 
stituito le basi per la costruzione di nuovi metodi e 
modelli di risoluzione di problemi. Con la sigla SI 
(Swarm intelligence) ci si riferisce a questo nuovo 
approccio. In particolare Ant colony optimitation 
(ACO) introdotta nel 1992 dal nostro illustre conna- 
zionale Marco Dorigo si ispira al modo di agire di al- 
cune specie di formiche. Vedremo come il compor- 
tamento sociale, quindi collettivo, sia stato simula- 
to con sofisticati modelli algoritmici, e come tali mo- 
delli siano stati utilizzati per risolvere diversi cate- 
gorie di problemi. Analizzeremo prima l'aspetto bio- 
logico da cui dedurremo il comportamento delle 
formiche, successivamente costruiremo un model- 
lo che lo descriva ed infine risolveremo un problema 
specifico con il metodo sviluppato. 



LA BIOLOGIA 
DELLE FORMICHE 

Quando le formiche hanno fame cercano cibo muo- 
vendosi casualmente. Nel momento in cui individua- 
no del cibo, dopo essersi saziate, incominciano a por- 
tarlo verso il formicaio. A questo punto avviene un 
processo biologico significativo, incominciano a de- 
positare scie di una sostanza chiamata feromone. Que- 
ste scie attraggono le altre formiche che così hanno la 
possibilità di individuare la fonte di cibo. Quando al- 
tre formiche mangiano e cominciano a tornare alla 
dimora i livelli di feromone crescono facendo au- 
mentare l'attrattiva verso le zone in cui è presente il 
cibo. Dopo poco si creano vere e proprie colonne di 



formiche che trasportano gli alimenti dalla fonte al 
formicaio, chissà quante volte ci sarà capitato di os- 
servarle. Va detto che il feromone per un processo di 
evaporazione con il passare del tempo diminuisce la 
sua azione fino ad esaurirsi. È quindi evidente che l'at- 
trattiva verso una determinata zona è "significativa" 
se vi sono più formiche che hanno raggiunto la zona 
e che quindi nel tempo mantengono alti i livelli di fe- 
romone. Questa ultima precisazione sottolinea la con- 
dotta sociale delle formiche. In altri termini solo gra- 
zie all'azione collettiva si stabilisce un comportamento 
utile a tutta la colonia che ha come obiettivo la ricer- 
ca del cibo. Vi sono molti esperimenti riportati in testi 
di biologia che dimostrano tale condotta. Ad esem- 
pio, si è provato a dividere la sorgente di cibo dal for- 
micaio con un ponte a due rami di lunghezza uguale 
(figura 1). Si è verificata una scelta casuale sul ramo 
da imboccare nel viaggio di andata alla ricerca di cibo. 
La scelta del ramo del ponte nel tragitto di ritorno, dal 
cibo alla dimora, influenzava le altre formiche che per- 
correvano nella maggior parte dei casi proprio quel 
ramo. Ciò è spiegato scientificamente proprio dal ri- 
chiamo dovuto alle scie di feromome depositate dal- 
la formica che ha trovato cibo. 
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Fig. 1: I due tipi di ponti su cui sono stati sviluppati gli esperimenti con le formiche. 
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Un secondo esperimento con un ponte formato da 
rami di differente lunghezza ha introdotto un nuovo 
elemento. Anche se si ha eguale probabilità di im- 
boccare uno dei due rami del ponte, le formiche che 
scelgono il ramo più corto troveranno prima il cibo. 
Così, le scie di feromone copriranno tale ramo che 
avrà maggiore probabilità di essere percorso. 



DALLA BIOLOGIA 
ALL'OTTIMIZZAZIONE 

Realizzare un modello matematico (algoritmico) ispi- 
rato al modo di agire delle formiche significa costrui- 
re un certo numero di formiche artificiali che grazie 
alla cooperazione appena descritta, ossia attraverso 
lo scambio di informazioni, concorrono alla risolu- 
zione di un problema. Su un grafo adottato come strut- 
tura di base per il nostro problema, si introducono 
delle formiche. L'idea è imitarle. Tra le prime applica- 




feromoni (dal greco pherein 
"trasportare" e hormon 
"eccitare") sono sostanze 
chimiche, che producono segnali 
attivi a basse concentrazioni, 
prodotte ed escrete da un 
individuo, animali in genere. 
Sono in grado di suscitare delle 
reazioni specifiche di tipo 
fisiologico e/o comportamentale 
in altri individui della stessa 
specie che vengono a contatto 
con esse. 

Una prima classificazione 
avviene in funzione dell'effetto 
prodotto: 

• feromoni traccianti (trace) che 
rilasciati da un individuo 
vengono seguiti da 
appartenenti alla stessa specie 
come una traccia. Si tratta 
della categoria su cui si basa 
ACO. 

• feromoni di allarme (alarm) 



che vengono emessi in 
situazioni di pericolo, 
inducendo un maggiore stato 
di vigilanza in quanti li 
captano. 

• feromoni innescanti o 
scatenanti (primer) che 
inducono nel ricevente 
modificazioni comportamentali 
e/o fisiologiche a lungo 
termine. 

• feromoni liberatori o di 
segnalazione (releaser) che 
scatenano comportamenti di 
aggressione o di 
accoppiamento nell'animale 
che li capta. 

• feromoni sessuali (sex) che 
producono attrattiva in altri 
individui. 

Ad esempio le api regine 
rilasciano un tipo di feromone 
che inibisce l'attività 
riproduttiva della operaie. 



zioni di ACO si scorge la soluzione del conosciuto pro- 
blema del commesso viaggiatore (TSP). Successiva- 
mente importanti risultati sono stati ottenuti in svariati 
campi, dagli algoritmi genetici al "network routing", 
ed in altri ancora. Per avere una prima idea vediamo 
come si può applicare ACO aTSR Ricordo che si trat- 
ta del problema di un commesso viaggiatore il quale 
per lavoro deve visitare n città la cui distanza (tra ogni 
coppia) è nota, e che ha il vincolo di passare una sola 
volta per ogni città; il suo obiettivo è trovare il tragitto 
più corto. Si tratta quindi di individuare un ciclo Ha- 
miltoniano su di un grafo corrispondente. Con ACO 



il problema si affronta predisponendo un certo nu- 
mero di formiche artificiali che si muovono sui verti- 
ci del grafo. Bisognerà concepire una variabile fero- 
mone associata agli archi e che sarà di volta in volta 
modificata da passaggio delle formiche. Ad ogni pas- 
so dell'algoritmo una formica che si trova nel nodo i, 
tra i possibili nodi che può raggiungere (i vincoli del pro- 
blema impongono di scartare quelli già visitati) sce- 
glierà secondo un processo stocastico un nodo j con 
una probabilità proporzionale alla quantità di fero- 
mone presente sull'arco. 



UNA PROBLEMA 
DI OTTIMIZZAZIONE 
COMBINATORIA 

Nel presentare le formulazioni dei modelli a seguire 
cercherò di attenermi al simbolismo usato da Marco 
Dorigo e dagli altri ricercatori di ACO, cosicché chi vo- 
lesse approfondire (si vedano i box relativi) non si tro- 
verà disorientato rispetto a questa presentazione. Co- 
minceremo con una formulazione generale per un 
problema di ottimizzazione combinatoria. È cono- 
sciuta anche come metaeuristica, proprio perché si 
comporta come un solutore di carattere generale, da 
adottare per un intero pacchetto di differenti proble- 
mi. Il modello P è caratterizzato dalla terna: <S, W, f > 
dove: 

• Lo spazio di ricerca S è definito su un insieme fini- 
to di variabili di decisione discrete Xi, con i com- 
preso tra 1 e n; 

• Un insieme W di vincoli sulle variabili; 

• Una funzione obiettivo f restituisce un valore rea- 
le a fronte di un valore appartenente a S, essa deve 
essere minimizzata. 

Con vij indichiamo un'istanza della variabile decisio- 
nale Xi . Le variabili vij saranno definite in rispettivi 
domini. Una soluzione s appartenente a S sarà otti- 
ma se non esiste nessun altra soluzione che applica- 
ta a f sia minore di f (s) . 

Nella costruzione del modello si deve tenere conto di 
ogni possibile soluzione componente a cui è associa- 
to un valore di feromone. Il valore di feromone è in- 
dicato con il valore ti,j e la soluzione componente cor- 
rispondente è indicata con ci,j . L'insieme di tutte le 
soluzioni è C (ben rappresentata con una matrice). 
Ecco come può essere descritto per macropassi l'al- 
goritmo di metaeuristica. 

Configura parametri e inizializza livelli di feromone 
While non è verificata la condizione di terminazione do 

AntSolution 

Ri ce rea Loca le 
AggiornaFeromone 
End while 
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La prima delle fasi indicata con AntSolution costruisce 
un insieme di m formiche artificiali e configura una 
prima soluzione componente q ; Inoltre, pone a ze- 
ro la prima delle soluzioni parziali s p=0 . Ad ogni pas- 
so dell'algoritmo la soluzione parziale si aggiorna di 
nuove possibili soluzioni che vengono ottenute ap- 
plicando N( s p) che sarà un sotto insieme dello spa- 
zio delle soluzioni C, ovviamente, nel rispetto dei vin- 
coli W. La scelta della soluzione componente da N( s p) 
è un processo stocastico che tiene conto dei livelli di 
feromone. Con RicercaLocale si occupa di migliorare 
localmente la soluzione prima di aggiornare i livelli di 
feromone. Tale fase è molto delicata ed è oggetto di 
studio al fine di ottenere risultati soddisfacenti. La fa- 
se AggiornaFeromone tiene conto della presenza del- 
le formiche su alcune componenti allo scopo di otte- 
nere una migliore e più rapida convergenza verso la 
soluzione ottima. 



USANDO GRAFI 

L'algoritmo appena formulato indica la strada mae- 
stra da seguire per realizzare ACO. Esso è più facil- 
mente comprensibile se anziché ad un problema di 
ottimizzazione combinatoria, che comunque rima- 
ne il più generale, si ci riferisce ad problema di attra- 
versamento di grafi. Noteremo che gli oggetti appena 
indicati assumono un significato di facile riscontro. Si 
considera un grafo Gc(YE) costituito da due insiemi: 
di nodi (o vertici) V e di archi E. Il grafico lo si può as- 
sociare al set di soluzioni componenti C. In partico- 
lare, le formiche si muovono sui nodi che per il pro- 
blema del commesso viaggiatore rappresentano le 
città. Gli insetti nello spostarsi aggiornano di conti- 
nuo la soluzione parziale. Inoltre, modificano le quan- 
tità di feromone negli archi che percorreranno. Le so- 
luzioni componente sono rappresentate da q j, nel 
caso specifico ciò indica che la città j deve essere visi- 
tata dopo i. Con i valori tj ; indicheremo la nuova quan- 
tità di feromone che si ha sull'arco (i,j) dopo il pas- 
saggio della formica. 



L'ALGORITMO 
AIUT SYSTEM 

Esistono diversi algoritmi ACO, il più remoto e signi- 
ficativo è stato introdotto da Marco Dorigo ed è co- 
nosciuto come ani system. Si tratta di un sistema discreto 
che avanza ad ogni iterazione. Tutti i livelli di feromo- 
ne vengono aggiornati in base all'azione delle m for- 
miche artificiali. La quantità tj ; indicante il feromo- 
ne presente sull'arco (i,j) viene aggiornata secondo 
questa espressione. 



r Uj =(l-p)-r ZJ + 2 Ar 



Dove m è il numero di formiche, r è coefficiente di 
evaporazione, specifica con il passare delle iterazioni 
quanto feromone viene liberato; è un valore compre- 
so tra e 1 ed è facile comprendere che valori vicini 
all'uno indichino elevati gradi di evaporazione, in pra- 
tica dopo una iterazione gran parte del feromone si 
volatilizza. Valori vicini allo zero al contrario model- 
lano una lenta evaporazione. La seconda parte del- 
l'espressione è il contributo di feromone dovuto dal- 
le m formiche nell'ultima iterazione. È chiaro che "l'at- 
trattiva", ossia la quantità di feromone, aumenta se il 
contributo delle singole formiche superala quantità eva- 
porata, e ciò ad intuito si ottiene quando quel ramo 
viene percorso da un "certo" numero di formiche. Ov- 
viamente, non tutte le formiche che percorrono un 
arco forniscono lo stesso contributo e va da se che il man- 
cato passaggio per l'arco dà contributo nullo. La quo- 
ta aggiunta dalla formichina k che è passata dall'arco 
(i,j) è stata indicata come elemento della sommato- 
ria con D, questo valore è pari a Q/L^. Dove Q è una co- 
stante e L è la lunghezza del tour costituito dalla formica 
k. A questo punto ci chiediamo come le formiche scel- 
gano gli archi da percorre tra quelli permessi (che non 
siano già stati visitati) . Come descritto si tratta di un pro- 
cesso stocastico che dipende dalla quantità di fero- 
mone che ciascun arco presenta. Più precisamente la 
probabilità che la formica k dalla città i scelga di rag- 
giungere la città j può essere espressa come segue: 




P k = - 

11 2 



•nij 



BN(s p ) T ij 



'Vy 



Questo se la soluzione componente ci,j appartiene a 
N(sp), altrimenti la probabilità è nulla. I due parame- 




Fig. 2: "Esempio di grafo su cui applicare ACO" 
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tri a e b sono delle costanti che esprimono il peso da 
assegnare al feromone in funzione della variabile h. 
Questa ultima variabile è l'inverso della distanza tra i 
nodi interessati. Dall'analisi dell'espressione che è un 
rapporto emerge evidente la dipendenza della pro- 
babilità dai livelli di feromone e dalla distanza, legati 
in un unico fattore (numeratore). La sommatoria al 
denominatore indica il totale di tali fattori a partire 
dalla città i. Risulta che la probabilità maggiore si avrà 
per quel nodo che esprime il maggiore fattore, che in 
definitiva è il rapporto tra livello di feromone e di- 
stanza modificato dall'elevazioni alle costanti prima de- 
scritte. Riesaminando l'algoritmo generale prima de- 
scritto alla luce degli strumenti matematici appena 
menzionati si scopre che l'espressione per il calcolo 
di t (livello di feromone) si può usare all'interno della 
procedura AggiornaFeromone, mentre RicercaLoca- 
le utilizzerà la probabilità calcolata per esplorare nuo- 
ve soluzioni componenti. La prima procedure per la con- 
figurazione si occuperà di dimensionare tutti i parametri 
incontrati, che ricordo sono r, a, b e Q. Tali parametri 
dipendono dal problema specifico che si intende risolvere. 



ALGORITMO MMAS 

Molti altri sviluppi si sono registrati dalla prima ver- 
sione di Ant system appena presentata. Tra tutte ne 
presentiamo uno: Max- Min Ant system (conosciuto 
con la sigla MMAS) , per gli altri rimando ai riferimenti 
sul web e alla bibliografia. In questa nuova versione 
sono presenti dei cambiamenti sulla modellazione 
del feromone a cui sono imposti dei limiti minimi e 
massimi e il cui aggiornamento è demandato ad una 
sola formica che si distingue per performance. La nuo- 
va espressione per il calcolo del feromone è adesso 
descritta così: 



T u =[(l-p)-T lJ+ AT bes >uY z 



rmax 
-ir min 



I livelli di feromone sono quindi compresi nell'inter- 
vallo descritto. La migliore variazione (delta) di fero- 
mone indicata con best non è altro che il rapporto 
1/Lbest, con L lunghezza del percorso della migliore 
formica, sempre se (i,j) appartiene al miglior tour; è 
infatti altrimenti. I bound sono come per l'algorit- 
mo precedente strettamente dipendenti dal proble- 
ma che si sta affrontando e quindi vanno calibrati ri- 
spetto ad essi. Va evidenziato che sebbene per alcune 
classi di problemi l'algoritmo MMAS abbia dato migliori 
risultati di Ant System, il secondo è quello che più si av- 
vicina al reale comportamento della comunità di for- 
miche, proprio perché le quantità di feromone che ad 
ogni iterazione si aggiornano sono il risultato del con- 
tributo di diverse formiche, proprio come accade in 
natura. Il metodo MMAS ci ricorda, invece, gli algo- 
ritmi evolutivi che abbiamo esaminato negli scorsi 



appuntamenti, anche se l'individuazione di una for- 
mica con le migliori performance non è da ritenersi 
un processo di selezione. Piuttosto ritorna intrinse- 
camente l'indice di valutazione di fitness. 



CAMPI 

DI APPLICAZIONE 

L'algoritmo inizialmente costruito sul problema del 
commesso viaggiatore, successivamente è stato te- 
stato su molti altri problemi NP-Hard. Le categorie di 
problemi su cui è stato applicato ACO sono: 

• Routing: ad esempio per l'assegnazione di buoni o 
problemi sulle reti; 

• assegnamento: il classico problema in cui bisogna 
far corrispondere entità a risorse (come il caso di 
oggetti a luoghi) ottimizzando una funzione obiet- 
tivo e rispettando determinati vincoli; 

• scheduling in cui bisogna gestire risorse e compiti in 
un fissato tempo; 

• Sottoinsiemi: come il caso di Knapsack. 

Per queste categorie la metaeuristica ha fornito risul- 
tati soddisfacenti anche se si è rilevato delicato e a vol- 
te ostico il lavoro di settaggio dei parametri di proget- 
to che differiscono a seconda del campo di applica- 
zione dell'algoritmo. Vanno ricordati i successi nel 
campo del routing su reti che sono stati raggiunti gra- 
zie al contributo di molti studiosi di tutto il mondo. 
Significativi i risultati anche nel campo industriale do- 
ve la ricerca si è concretizzata in effettivi utilizzi di au- 
tomazione industriale e di ottimizzazione di percorsi. 
Emblematico è il caso della società di logistica svizze- 
ra AntOptima che ha sviluppato una serie di tool che 
si basano proprio su ACO. Tra gli strumenti vi è DY- 
VOIL che gestisce la distribuzione di carburante per 
riscaldamento su mezzi di diverse dimensioni usato per 
la prima volta dalla società svizzera Pina Petroli. 



CONCLUSIONI 

È davvero sorprendente verificare i brillanti risultati 
ottenuti con ACO. Non ripeterò i campi in cui si stan- 
no sviluppando significative conquiste, mi interessa qui 
sottolineare il vivo interesse mostrato per la questio- 
ne da studiosi e programmatori che hanno piena- 
mente approvato lo studio introdotto da Marco Do- 
rigo. La Swarm Intelligence è un campo in continua 
evoluzione che mostra come millenni di adattamen- 
to applicati ali anatura possano costituire un model- 
lo valido da replicare in programmazione 
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